google api nodejs client
v0.1.0
Node.js Client -Bibliothek für die Verwendung von Google APIs. Unterstützung für die Autorisierung und Authentifizierung mit OAuth 2.0, API Keys und JWT -Token ist enthalten.
Google APIs
Erste Schritte
Installation
Verwenden der Clientbibliothek
Proben
API -Referenz
Authentifizierung und Autorisierung
OAuth2 -Kunde
API -Schlüssel verwenden
Anwendungsausfallanmeldeinformationen
Service -Konto -Anmeldeinformationen
Einstellen globaler oder Service-Level-Auth
Verwendung
Anfrage angeben
Medien -Uploads
Anfrageoptionen
Mit einem Proxy
Unterstützte APIs
Typoskript
Http/2
Lizenz
Beitragen
Fragen/Probleme?
Die vollständige Liste der unterstützten APIs finden Sie im Google APIS Explorer. Die API -Endpunkte werden automatisch generiert. Wenn sich die API nicht in der Liste befindet, wird sie derzeit nicht von dieser API -Client -Bibliothek unterstützt.
Bei Verwendung von Google Cloud-Plattform-APIs wie DataStore, Cloud-Speicher oder Pub/Sub ist es ratsam, die @Google-Cloud-Client-Bibliotheken zu nutzen. Diese Bibliotheken sind speziell gebaute idiomatische Node.JS-Clients für bestimmte Google Cloud-Plattformdienste. Wir empfehlen, einzelne API-Pakete wie @google-cloud/storage zu installieren. Um eine umfassende Liste der API-spezifischen Pakete von Google Cloud-Plattform zu untersuchen, finden Sie unter https://cloud.google.com/nodejs/docs/reference.
Diese Kundenbibliotheken werden offiziell von Google unterstützt. Diese Bibliotheken gelten jedoch als vollständig und befinden sich im Wartungsmodus. Dies bedeutet, dass wir kritische Fehler und Sicherheitsprobleme angehen, aber keine neuen Funktionen hinzufügen. Für Google Cloud-Plattform-APIs empfehlen wir die Verwendung von Google-Cloud-Knoten, die unter aktiver Entwicklung steht.
Diese Bibliothek unterstützt die Wartung LTS, Active LTS und die aktuelle Version von Node.js. Weitere Informationen finden Sie im Release -Zeitplan von Node.js.
Diese Bibliothek ist auf npm verteilt. Um es als Abhängigkeit hinzuzufügen, führen Sie den folgenden Befehl aus:
$ npm boogleapis installieren
Wenn Sie die Startzeiten verkürzen müssen, können Sie alternativ ein Submodul als eigene Abhängigkeit installieren. Wir bemühen uns, Submodule zu veröffentlichen, die nicht in dieser Liste enthalten sind. Um es als Abhängigkeit hinzuzufügen, führen Sie den folgenden Beispielbefehl aus und ersetzen Sie dies durch Ihre bevorzugte API:
$ npm install @googleapis/docs
Sie können diese Suche auf npm ausführen, um eine Liste der verfügbaren Submodules zu finden.
Dies ist ein sehr einfaches Beispiel. Dies erstellt einen Blogger -Kunden und ruft die Details eines Blogs mit der Blog -ID ab:
const {google} = required ('googleapis'); // Jede API kann mehrere Versionen unterstützen. Mit diesem Beispiel erhalten wir // v3 der Blogger -API und verwenden einen API -Schlüssel zur Authentifizierung.Const Blogger = Google.blogger ({{{{
Version: 'v3',
Auth: 'dein API -Schlüssel'}); const params = {
BlogID: '3213900'}; // Erhalten Sie den Blogdetailsblogger.blogs.get (Params, (err, res) => {
if (err) {console.Error (err); throw err;
}
console.log (`Die Blog -URL ist $ {res.data.url}`);});Anstatt Rückrufe zu verwenden, können Sie auch Versprechen verwenden!
Blogger.blogs.get (Params)
.then (res => {console.log (`Die Blog -URL ist $ {res.data.url}`);
})
.Catch (error => {console.Error (error);
});Oder asynchron/wartet:
Async -Funktion runsample () {
const res = warte blogger.blogs.get (params);
console.log (`Die Blog -URL ist $ {res.data.url}`);} runsample (). catch (console.Error);Alternativ können Sie direkt an die APIs Anrufe tätigen, indem Sie ein Submodul installieren:
const docs = require ('@googleapis/docs') const auth = new docs.Auth.googleauth ({{{
KEYFILENAME: 'path_to_service_account_key.json', // Scopes können entweder als Array oder als einzelne, von Space-Delimited-Zeichenfolge angegeben werden.
Scopes: ['https://www.googleapis.com/auth/documents' weibliche }) const authclient = act auth.getClient (); const client = wartete docs.docs ({Version: 'v1', Auth: Authclient }); const creeteresponse = warte client.documents.create ({requestBody: {title: 'dein neues dokument!',},}); console.log (creeveresponse.data);Es gibt viele Proben? Wenn Sie versuchen herauszufinden, wie Sie eine API verwenden, schauen Sie sich zuerst dort an! Wenn es ein Beispiel gibt, das Sie fehlen müssen, können Sie ein Problem einreichen.
Diese Bibliothek verfügt über einen vollständigen Satz von API -Referenzdokumentation. Diese Dokumentation ist automatisch generiert und der Ort kann sich ändern.
Es gibt mehrere Möglichkeiten, sich mit Google APIs zu authentifizieren. Einige Dienste unterstützen alle Authentifizierungsmethoden, während andere möglicherweise nur ein oder zwei unterstützen.
OAuth2 - Auf diese Weise können Sie API -Anrufe im Namen eines bestimmten Benutzers tätigen. In diesem Modell besucht der Benutzer Ihre Anwendung, meldet sich mit seinem Google -Konto an und bietet Ihrer Bewerbung eine Genehmigung gegen eine Reihe von Scopes. Erfahren Sie mehr.
API -Schlüssel - Mit einem API -Schlüssel können Sie auf Ihren Dienst von einem Client oder dem Server zugreifen. In der Regel weniger sicher, ist dies nur auf einer kleinen Teilmenge von Diensten mit begrenzten Bereichen verfügbar. Erfahren Sie mehr.
Anwendungsausfall -Anmeldeinformationen - Bietet automatischen Zugriff auf Google -APIs über das Google Cloud SDK für die lokale Entwicklung oder den GCE -Metadatenserver für Anwendungen, die auf der Google Cloud -Plattform bereitgestellt werden. Erfahren Sie mehr.
Service -Account -Anmeldeinformationen - In diesem Modell spricht Ihre Anwendung direkt mit einem Servicekonto bei Google APIs. Es ist nützlich, wenn Sie eine Backend -Anwendung haben, die direkt mit Google APIs aus dem Backend übergibt. Erfahren Sie mehr.
Weitere Informationen zum Authentifizierungs Client finden Sie in der Google Auth -Bibliothek.
Dieses Modul verfügt über einen OAuth2 -Client, mit dem Sie ein Zugriffstoken abrufen, aktualisieren und die Anforderung nahtlos wiederholen können. Die Grundlagen der OAuth2 -Implementierung von Google werden in der Google Autorisierung und Authentifizierungsdokumentation erläutert.
In den folgenden Beispielen benötigen Sie möglicherweise eine CLIENT_ID , CLIENT_SECRET und REDIRECT_URL . Sie können diese Informationen finden, indem Sie zur Entwicklerkonsole gehen und auf Ihr Projekt -> APIs & Auth -> Anmeldeinformationen klicken.
Navigieren Sie zur Cloud -Konsole und erstellen Sie eine neue OAuth2 -Client -ID
Wählen Sie Web Application für den Anwendungstyp aus
Fügen Sie einen autorisierten Umleitungs -URI mit dem Wert http://localhost:3000/oauth2callback hinzu (oder anwendbarer Wert für Ihr Szenario).
Klicken Sie auf dem folgenden Bildschirm auf Create und Ok
Klicken Sie auf das Symbol Download neben Ihrer neu erstellten OAuth2 -Client -ID
Stellen Sie sicher, dass diese Datei an sicherem Ort speichern und diese Datei nicht in Quellsteuerung überprüfen!
Weitere Informationen zu OAuth2 und wie es funktioniert, finden Sie hier.
Eine vollständige Beispielanwendung, die mit dem OAuth2 -Client autorisiert und authentifiziert wird, finden Sie unter samples/oauth2.js .
Um die Berechtigungen von einem Benutzer zum Abrufen eines Zugriffstokens zu bitten, umleiten Sie sie zu einer Einverständniserklärung. So erstellen Sie eine Einwilligungsseiten -URL:
const {google} = required ('googleapis'); const oauth2client = new Google.auth.oauth2 (
Your_client_id,
Your_client_secret,
Your_redirect_url); // generieren Sie eine URL, die Berechtigungen für Blogger und Google Calendar ScopesConst Scopes = [
'https://www.googleapis.com/auth/blogger',
'https://www.googleapis.com/auth/calendar'];const url = oauth2client.generateAuthurl ({{{{{{{{{{{{{{{
// 'online' (Standard) oder 'offline' (erhält refresh_token)
access_type: 'offline',
// Wenn Sie nur einen Umfang benötigen, können Sie es als Zeichenfolge übergeben
Umfang: Scopes}); Wichtiger Hinweis - Der refresh_token wird nur in der ersten Autorisierung zurückgegeben. Weitere Details hier.
Sobald ein Benutzer auf der Einverständniserschaftsseite Berechtigungen erteilt hat, wird Google die Seite in die Umleitungs -URL umgeleitet, die Sie mit einem Code -Abfrageparameter zur Verfügung gestellt haben.
GET /oauthcallback?code={authorizationCode}Mit dem zurückgegebenen Code können Sie wie unten gezeigt nach einem Zugriffstoken bitten:
// Dies liefert ein Objekt mit dem Access_Token und dem request_token.// diese an einem sicheren Ort, damit sie zu einem späteren Zeitpunkt verwendet werden können.
Mit den Anmeldeinformationen, die auf Ihrem OAuth2 -Kunden festgelegt sind, können Sie bereit sind zu gehen!
Zugangsantrieb verfallen ab. Diese Bibliothek verwendet automatisch ein Aktualisierungs -Token, um ein neues Zugangstoken zu erhalten, wenn es abgelaufen ist. Eine einfache Möglichkeit, um sicherzustellen, dass Sie immer die neuesten Token speichern, besteht darin, das tokens -Event zu verwenden:
OAuth2client.on ('Tokens', (Tokens) => {
if (tokens.refresh_token) {// Speichern Sie die in meiner Datenbank! console.log (tokens.refresh_token);
}
console.log (tokens.access_token);}); Dieses Token -Ereignis erfolgt nur in der Erstberechtigung, und Sie müssen Ihren access_type auf offline einstellen, wenn Sie die generateAuthUrl -Methode aufrufen, um das Aktualisierungstoken zu erhalten. Wenn Sie Ihrer App bereits die erforderlichen Berechtigungen erteilt haben, ohne die entsprechenden Einschränkungen für den Empfang eines Aktualisierungs-Tokens festzulegen, müssen Sie den Antrag neu autorisieren, um ein frisches Aktualisierungs-Token zu erhalten. Sie können hier den Zugriff Ihrer App auf Ihr Konto widerrufen.
Um die refresh_token zu einem späteren Zeitpunkt festzulegen, können Sie die Methode setCredentials verwenden:
oAuth2client.setcredentials ({{{
request_token: `stored_refresh_token`});Sobald der Kunde über ein Aktualisierungspunkt verfügt, werden im nächsten Anruf bei der API zu Zugangsstoken erfasst und aktualisiert.
Refresh -Token können aufhören zu arbeiten, nachdem sie gewährt wurden, entweder weil:
Der Benutzer hat den Zugriff Ihrer App widerrufen
Der Refresh -Token wurde seit 6 Monaten nicht mehr verwendet
Der Benutzer hat die Passwörter geändert und das Aktualisierungstoken enthält Google Mail -Bereiche
Das Benutzerkonto hat eine maximale Anzahl von Live -Aktualisierungs -Token überschritten
Die Anwendung hat einen Status von "Tests" und der Einwilligungsbildschirm ist für einen externen Benutzertyp konfiguriert, wodurch das Token in 7 Tagen abgelaufen ist
Als Entwickler sollten Sie Ihren Code schreiben, um den Fall zu bewältigen, in dem ein Aktualisierungs -Token nicht mehr funktioniert.
Möglicherweise müssen Sie einen API -Schlüssel mit der Anfrage senden, die Sie stellen werden. Im Folgenden wird ein API -Schlüssel verwendet, um den Blogger -API -Service zu beantragen, um den Namen, die URL eines Blogs und die Gesamtmenge an Posts abzurufen:
const {google} = required ('googleapis'); const blogger = google.blogger_v3 ({{{{{
Version: 'v3',
Auth: 'your_api_key' // Geben Sie hier Ihre API -Schlüssel an}); const params = {
BlogID: '3213900'}; Async -Funktion main (params) {
const res = warte blogger.blogs.get ({blogId: params.blogid});
console.log (`$ {res.data.name} hat $ {res.data.posts.totalitems} Beiträge! Die Blog -URL ist $ {res.data.url}`)}; main (). catch (console. Fehler);Weitere Informationen zu API -Schlüssel finden Sie in der Dokumentation.
Anstatt einen OAuth2 -Client, einen JWT -Client oder einen Berechnung des Clients manuell zu erstellen, kann die Auth -Bibliothek je nach Umgebung, unter der Ihr Code ausgeführt wird, den richtigen Anmeldeinformationsart für Sie erstellen.
Beispielsweise wird ein JWT -Auth -Client erstellt, wenn Ihr Code auf Ihrem lokalen Entwicklergerät ausgeführt wird, und ein Computer -Client wird erstellt, wenn derselbe Code auf einer konfigurierten Instanz von Google Compute Engine ausgeführt wird. Der folgende Code zeigt, wie abhängig von der Laufzeitumgebung einen Standard -Anmeldeinformationsart abgerufen wird.
Um Standard -Anmeldeinformationen lokal mit dem Google Cloud SDK zu verwenden, rennen Sie:
$ gcloud auth Application-Default Anmeldung
Beim Ausführen in GCP wird Service Authorize automatisch über den GCE -Metadatenserver bereitgestellt.
const {google} = required ('googleapis'); const compute = google.compute ('v1'); Async function main () {
const auth = new Google.auth.googleauth ({// Scopes kann entweder als Array oder als einzelner, space-delimited string.scopes angegeben werden: ['https://www.googleapis.com/auth/compute']
});
const authclient = warte auth.getClient ();
// die aktuelle Projekt -ID erhalten
const Project = warte auth.getProjectId ();
// Die Liste der GCE -Zonen innerhalb eines Projekts abrufen.
const res = warte compute.zones.list ({project, auth: authclient});
console.log (res.data);} main (). catch (console.Error);Mit Service-Konten können Sie mithilfe eines Roboterkontos eine Authentifizierung auf Server-Server-App-Ebene ausführen. Sie erstellen ein Servicekonto, laden Sie eine Schlüsseldatei herunter und verwenden dies, um sich in Google APIs zu authentifizieren. So erstellen Sie ein Servicekonto:
Gehen Sie zur Tastatur -Tastatur -Seite erstellen
Wählen Sie in der Dropdown -Art New Service Account aus
Klicken Sie auf die Schaltfläche Create
Speichern Sie die Datei für Service -Konto -Anmeldeinformationen an einem sicheren Ort und überprüfen Sie diese Datei nicht in Quellvertretung ! Um auf die Datei zur Anmeldeinformation des Service -Kontos zu verweisen, haben Sie einige Optionen.
GOOGLE_APPLICATION_CREDENTIALS env var Sie können den Prozess mit einer Umgebungsvariablen mit dem Namen GOOGLE_APPLICATION_CREDENTIALS beginnen. Der Wert dieser Umwelt sollte der vollständige Pfad zur Datei des Service -Konto -Anmeldeinformationen sein:
$ Google_application_credentials =./Your-secret-key.json node server.js
keyFile -Eigenschaft Alternativ können Sie den Pfad zum Service -Konto -Anmeldeinformationsdatei über die keyFile -Eigenschaft im GoogleAuth -Konstruktor angeben:
const {google} = required ('googleapis'); const auth = new Google.auth.googleauth ({{{
KEYFILE: '/path/to/your-secret-key.json', ',
Scopes: ['https://www.googleapis.com/auth/cloud-platform'],}); Sie können das auth als globale oder Service-Ebene-Option festlegen, sodass Sie nicht jede Anfrage angeben müssen. Beispielsweise können Sie auth als globale Option festlegen:
const {google} = required ('googleapis'); const oauth2client = new Google.auth.oauth2 (
Your_client_id,
Your_client_secret,
Your_redirect_url); // Setzen Sie Auth als globaler defaultGoogle.options ({{{{
AUTH: OAuth2Client});Anstatt die Option weltweit festzulegen, können Sie den Authentifizierungs-Client auch auf Service-Ebene festlegen:
const {google} = required ('googleapis'); const oauth2client = new Google.auth.oauth2 (
Your_client_id,
Your_client_secret,
Your_redirect_url); const Drive = google.drive ({{
Version: 'v2',
AUTH: OAuth2Client});Weitere Informationen finden Sie im Abschnitt Optionen.
Der Körper der Anforderung ist im requestBody der Anforderung angegeben. Der Körper wird als JavaScript -Objekt mit Schlüssel-/Wertpaaren angegeben. In diesem Beispiel wird beispielsweise einen Beobachter erstellt, der Benachrichtigungen zu einem Google Cloud Pub/Sub -Thema veröffentlicht, wenn E -Mails an ein Google Mail -Konto gesendet werden:
const res = warte gmail.users.watch ({{{
BenutzerID: 'Ich',
RequestBody: {// Ersetzen
}}); console.log (res.data); Dieser Client unterstützt mehrteilige Medien -Uploads. Die Ressourcenparameter werden im requestBody -Parameterobjekt angegeben, und das Medien selbst ist im media.body mit dem in media.mimeType angegebenen MIME-Typ angegeben.
Dieses Beispiel lädt eine einfache Textdatei mit dem Titel "Test" und Inhalt "Hello World" in Google Drive hoch.
const Drive = google.drive ({{
Version: 'v3',
AUTH: OAuth2Client}); const res = act totrife.files.create ({{{{{{{{{{{{{{{{
RequestBody: {Name: 'Test', Mimetype: 'Text/Plain'
},
Medien: {Mimetype: 'Text/Plain', Körper: 'Hallo Welt' '
}}); Sie können Medien auch hochladen, indem Sie media.body als lesbarer Stream angeben. Auf diese Weise können Sie sehr große Dateien hochladen, die nicht in den Speicher passen.
const fs = require ('fs'); const Drive = google.Drive ({{{{
Version: 'v3',
AUTH: OAuth2Client}); Async function main () {
const res = acait drauf.files.create ({requestBody: {name: 'testimage.png', mimetype: 'image/png'}, medien: {mimetyp .png ')}
});
console.log (res.data);} main (). catch (console.Error); Weitere Beispiele für Erstellungs- und Modifikationsanforderungen mit Medienanhängen finden Sie in der Probe samples/drive/upload.js .
Für eine weitere fein abgestimmte Steuerung über die Tätigkeit Ihrer API-Aufrufe bieten wir Ihnen die Möglichkeit, zusätzliche Optionen anzugeben, die direkt auf das in dieser Bibliothek verwendete Objekt "Gaxios" angewendet werden können, um Netzwerkaufrufe an die API zu tätigen.
Sie können zusätzliche Optionen entweder im globalen google -Objekt oder auf Service -Client -Basis angeben. Die Optionen, die Sie angeben, werden dem gaxios -Objekt beigefügt, sodass GAXIOIOs, was gaxios unterstützt, diese Bibliothek unterstützt. Sie können auch globale oder pro-service-Anforderungsparameter angeben, die allen API-Aufrufen beigefügt werden.
Eine vollständige Liste unterstützter Optionen finden Sie hier.
Sie können Standardoptionen auswählen, die mit jeder Anfrage gesendet werden. Diese Optionen werden für jeden vom Google -Client instanziierten Dienst verwendet. In diesem Beispiel wird die timeout -Eigenschaft von GaxiosOptions für jede Anfrage festgelegt:
const {google} = required ('googleapis'); google.options ({{{
// Alle mit diesem Objekt gestellten Anfragen verwenden diese Einstellungen, sofern nicht überschrieben.
Zeitüberschreitung: 1000,
auth: auth});Sie können auch die mit jeder Anfrage gesendeten Parameter ändern:
const {google} = required ('googleapis'); google.options ({{{
// Alle Anfragen von allen Diensten enthalten den oben genannten Abfrageparameter
// Es sei denn, sie überschrieben entweder in einem Service -Client oder in einzelnen API -Aufrufen.
Params: {Quotauser: '[email protected]' '
}});Sie können beim Erstellen eines Service -Clients auch Optionen angeben.
const blogger = google.blogger ({{
Version: 'v3',
// Alle mit diesem Objekt gestellten Anfragen verwenden den angegebenen Auth.
Auth: 'API -Schlüssel';}); Auf diese Weise verwendet jeder API -Anruf mit diesem Service -Client 'API KEY' um sich zu authentifizieren.
Hinweis: Erstellte Clients sind unveränderlich , sodass Sie eine neue erstellen müssen, wenn Sie verschiedene Optionen angeben möchten.
Ähnlich wie die obigen Beispiele können Sie auch die für jeden Anruf eines bestimmten Dienstes verwendeten Parameter ändern:
const blogger = google.blogger ({{
Version: 'v3',
// Alle Anfragen, die mit diesem Service -Client gestellt werden
// BlogID -Abfrageparameter, es sei denn, in einzelnen API -Aufrufen überschrieben.
Params: {blogid: '3213900'
}}); // Anrufe mit diesem Laufwerksclient enthält nicht den BlogID -Abfrage -Parameter.Const Drive = google.drive ('v3'); ... Sie können ein auth -Objekt angeben, das pro Anforderung verwendet werden soll. Jede Anfrage erbt auch die auf Service und globalen Ebene angegebenen Optionen.
Zum Beispiel:
const {google} = required ('googleapis'); const bigQuery = google.bigQuery ('v2'); Async function main () {
// Diese Methode sucht nach GCLOUD_Project und Google_Application_credentials
// Umgebungsvariablen.
const auth = new Google.auth.googleauth ({Scopes: ['https://www.googleapis.com/auth/cloud-platform']
});
const authclient = warte auth.getClient ();
const ProjectID = wartet auth.getProjectId ();
const request = {projectId, dataSeTID: '<your_dataset_id>', // Dies ist eine "Request-Level" OptionAuth: Authclient
};
const res = wartet bigQuery.datasets.delete (Anfrage);
console.log (res.data);} main (). catch (console.Error); Sie können Gaxios -Optionen pro Anforderung auch überschreiben, z. B. url , method und responseType .
Zum Beispiel:
const res = warte auf Drive.files.export ({{{
DateiId: 'Asxkjod9S79', // ein Google -Dokument
mimetype: 'application/pdf'}, {
// Stellen Sie sicher, dass wir die binären Daten erhalten
Antworttyp: 'Stream'});Sie können die folgenden Umgebungsvariablen verwenden, um HTTP- und HTTPS -Anfragen zu proxy:
HTTP_PROXY / http_proxy
HTTPS_PROXY / https_proxy
Wenn http_proxy / http_proxy festgelegt wird, werden sie verwendet, um nicht-SSL-Anforderungen zu proxy, die keine explizite Proxy-Konfigurationsoption vorhanden sind. In ähnlicher Weise wird https_proxy / https_proxy für SSL -Anforderungen respektiert, die keine explizite Proxy -Konfigurationsoption haben. Es ist gültig, einen Proxy in einer der Umgebungsvariablen zu definieren, überschreiben Sie ihn jedoch für eine bestimmte Anforderung unter Verwendung der Proxy -Konfigurationsoption.
Sie können programmgesteuert die Liste der unterstützten APIs und alle verfügbaren Versionen erhalten:
const {google} = required ('googleapis'); const apis = google.getSupportedapis ();Dadurch wird ein Objekt mit dem API -Namen als Objekteigenschaftsnamen und einem Array von Versionszeichenfolgen als Objektwerte zurückgegeben.
Diese Bibliothek ist in TypeScript geschrieben und bietet Typen außerhalb des Box. Alle für jede API generierten Klassen und Schnittstellen werden unter dem Namespace ${apiName}_${version} exportiert. Beispielsweise sind die Antriebs -V3 -API -Typen alle im Namespace drive_v3 verfügbar:
importieren {
Google, // das oberste Objekt, das zum Zugriff auf Dienste verwendet wird
Drive_v3, // für jeden Service -Client gibt es einen exportierten Namespace
Auth, // Namespace für authbezogene Typen
Gemeinsame, allgemeine Typen in der gesamten Bibliothek} aus 'googleapis'; // Hinweis: Die Verwendung explizite Typen wie `auth.googleauth` sind nur für // Demonstrationszwecke hier. Im Allgemeinen würden diese Typen mit TypeScript abgeleitet.
Version: 'v3',
Auth,}); // Es gibt generierte Typen für jeden Satz von Anforderungsparameterconst ListParams: Drive_V3.Params $ ressource $ filen $ list = {}; const res = act auf Drive.files.list (ListParams); // Es gibt generiert, dass generiert wird, dass generiert wurde Typen für die Antwortfelder sowie Wellconst LISTRESULTS: Drive_V3.Schema $ filelist = res.data; Diese Bibliothek unterstützt HTTP/2. Um dies zu aktivieren, verwenden Sie die Option http2 Anywhere Anforderungsparameter akzeptiert:
const {google} = required ('googleapis'); google.options ({{{
http2: true,});HTTP/2 ist häufig leistungsfähiger, da es Multiplexen mehrerer gleichzeitiger Anforderungen über einen einzelnen Sockel ermöglicht. In einer herkömmlichen HTTP/2 -API ist der Kunde direkt dafür verantwortlich, die Sitzungen zu öffnen und zu schließen, um Anfragen zu stellen. Um die Kompatibilität mit der vorhandenen API aufrechtzuerhalten, wird dieses Modul automatisch vorhandene Sitzungen wiederverwendet, die nach dem Leerlauf für 500 ms gesammelt werden. Ein Großteil der Leistungsgewinne wird in Workloads im Stapelstil und engen Schleifen sichtbar sein.
In unseren Versionshinweise finden Sie eine detaillierte Liste von Bruchänderungen und neuen Funktionen. Wenn Sie diese Bibliothek vor 25.x verwendet haben, finden Sie in unseren Versionshinweise, um Ihren Code von 24.xx auf 25.xx zu migrieren. Es ist ziemlich einfach :)
Diese Bibliothek ist unter Apache 2.0 lizenziert. Der vollständige Lizenztext ist in der Lizenz erhältlich.
Wir lieben Beiträge! Bevor Sie eine Pull -Anfrage einreichen, ist es immer gut, zuerst mit einem neuen Problem zu beginnen. Um mehr zu erfahren, siehe Beitrag.
Stellen Sie Ihre Entwicklungsfragen zu Stackoverflow.
Wenn Sie einen Fehler/Problem gefunden haben, stellen Sie ihn bitte auf GitHub ein.
