Codebeispiele ausführen

cURL

Einrichten

1. Folgen Sie der Anleitung in der API-Dokumentation, um ein Projekt für Ihre Anwendung zu erstellen oder auszuwählen und die API zu aktivieren.
2. Erstellen Sie in der Cloud Console einen API-Schlüssel.
3. Erstellen Sie in der Cloud Console eine OAuth-Client-ID für eine Webanwendung und verwenden Sie https://developers.google.com/oauthplayground als Weiterleitungs-URI.
4. Klicken Sie im OAuth 2.0 Playground auf OAuth 2.0 Configuration settings.
5. Setzen Sie ein Häkchen bei Use your own credentials (Eigene Anmeldedaten verwenden).
6. Geben Sie die in Schritt 3 generierte Client-ID und den Clientschlüssel ein.
7. Geben Sie im Feld „Bereiche“ den Bereich ein, den Sie für Ihre Methode verwenden möchten, und klicken Sie auf APIs autorisieren.
8. Optional: Wenn ein Anmeldebildschirm angezeigt wird, wählen Sie das Konto aus, das verwendet werden soll.
9. Optional: Wenn ein Autorisierungsbildschirm angezeigt wird, klicken Sie auf Accept (Akzeptieren).
10. Klicken Sie auf Autorisierungscode für Tokens austauschen. Ein Token wird zurückgegeben.
11. Ersetze [YOUR_API_KEY] im cURL-Codebeispiel durch den API-Schlüssel, der in Schritt 2 generiert wurde: 'https://www.googleapis.com/drive/v3/files?key=[YOUR_API_KEY]' \
12. Ersetzen Sie im cURL-Codebeispiel [YOUR_ACCESS_TOKEN] durch das Zugriffstoken, das in Schritt 10 generiert wurde: --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \

Codebeispiel ausführen

Führen Sie in der Befehlszeile den Befehl „cURL“ aus. Der Befehl sollte in etwa so aussehen:

curl \
'https://www.googleapis.com/drive/v3/files?key=AIzaSyBiKcaoXmVApwnT24hitQG_dwjGvAj6Ddw' \
--header 'Authorization: Bearer ya29.a0ARrdaM_yQn9MWBpJgKPx880BSnRYIizRYIDz0JN9e66nSliIYpqNXmPsvv2ccfplCTG_U4b1' \
--header 'Accept: application/json' \
--compressed

JavaScript

Einrichten

1. Folgen Sie der Anleitung in der API-Dokumentation, um ein Projekt für Ihre Anwendung zu erstellen oder auszuwählen und die API zu aktivieren.
2. Erstellen Sie in der Cloud Console einen API-Schlüssel.
3. Erstellen Sie in der Cloud Console OAuth-Client-ID-Anmeldedaten für eine Webanwendung und legen Sie die autorisierten JavaScript-Quellen fest, um die URL zu identifizieren, von der Anfragen gesendet werden, z. B. http://localhost.
4. Kopieren Sie das vollständige Codebeispiel in eine lokale Datei, auf die Ihr Webserver zugreifen kann, z. B. /var/www/html/example.html.

5. Suchen Sie im Codebeispiel die Zeile, in der der API-Schlüssel oder die Client-ID festgelegt ist, und ersetzen Sie den Wert durch die in Schritt 2 und 3 generierten Werte:

   • API-Schlüssel: gapi.client.setApiKey(YOUR_API_KEY);
   • OAuth 2.0-Client-ID: gapi.client.init({ 'clientId': 'YOUR_CLIENT_ID',

Codebeispiel ausführen

1. Öffnen Sie die Datei in Ihrem Browser, z. B. http://localhost/example.html. Wir empfehlen die Verwendung eines Browsers mit einer Debugging-Konsole wie Google Chrome.
2. Optional: Wenn ein Anmeldebildschirm angezeigt wird, wählen Sie das Konto aus, das verwendet werden soll.
3. Optional: Wenn ein Autorisierungsbildschirm angezeigt wird, klicken Sie auf Accept (Akzeptieren). In der Debugging-Konsole sollte die Methodenantwort als JSON-Objekt angezeigt werden.

Java

Voraussetzungen

• Java 1.7 oder höher.
• Gradle 7 oder höher.

Einrichten

1. Folgen Sie der Anleitung in der API-Dokumentation, um ein Projekt für Ihre Anwendung zu erstellen oder auszuwählen und die API zu aktivieren.
2. Abhängig davon, auf welche Art von Daten die Methode zugreift, erstellen Sie einen API-Schlüssel (öffentliche Daten) oder eine OAuth 2.0-Client-ID (private Daten).
3. Wählen Sie als Anwendungstyp Desktop-App aus.
4. Wenn Sie eine OAuth 2.0-Client-ID erstellt haben, laden Sie die JSON-Datei mit Ihren OAuth 2.0-Anmeldedaten herunter. Diese Datei hat einen Namen wie client_secret_CLIENTID.json, wobei CLIENTID die Client-ID für Ihr Projekt ist.

5. Führen Sie in Ihrem Arbeitsverzeichnis die folgenden Befehle aus, um eine neue Projektstruktur zu erstellen:

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

6. Wenn Sie in Schritt 2 eine OAuth 2.0-Client-ID erstellt haben, benennen Sie die heruntergeladene JSON-Datei in client_secret.json um.

7. Speichern Sie die umbenannte Datei im Verzeichnis src/main/resources, das Sie in Schritt 5 erstellt haben.

8. Öffnen Sie in Ihrem Arbeitsverzeichnis die Datei build.gradle und ersetzen Sie ihren Inhalt durch Folgendes:

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       API_SPECIFIC_DEPENDENCY
   }
   

9. Ersetzen Sie in der Datei build.gradle die Zeile API_SPECIFIC_DEPENDENCY durch eine Anweisung zum Kompilieren von Code für die API, die Sie aufrufen. Hier ein Beispiel für die YouTube Analytics API:

   compile 'com.google.apis:google-api-services-youtubeAnalytics:v2-rev16-1.23.0'
   

   Die Anleitung folgt dieser Vorlage:

   compile 'com.google.apis:google-api-services-API_NAME:API_VERSION-   revREVISION-CL_VERSION'
   

Dabei gilt:

• API_NAME ist der auf GitHub für die API aufgeführte API-Name. Klicken Sie auf der Seite Unterstützte Google APIs auf den Versionslink neben Ihrer API, um den Namen aufzurufen. Über den Versionslink wird GitHub aufgerufen. Der API-Name befindet sich in der oberen Mitte der Seite und ihm ist googleapis/google-apis-services- vorangestellt. Für Version 3 der Drive API ist beispielsweise API_NAME drive.
• API_VERSION ist die API-Version, die auf der Seite „Unterstützte Google APIs“ unter dem API-Namen aufgeführt ist.
• REVISION ist die Überarbeitungsnummer, die in der JavaDoc-Referenz für die API aufgeführt ist. Die JavaDoc-Referenz finden Sie unter https://googleapis.dev/java/google-api-services-API_NAME/latest/index.html.
• CL_VERSION ist die Version der Clientbibliothek. Dieser Wert ist auch in der JavaDoc-Referenz enthalten.
• Kopieren Sie aus Ihrem Arbeitsverzeichnis das Codebeispiel aus APIs Explorer in src/main/java/ApiExample.java. Der Klassenname in jeder Stichprobe lautet ApiExample, sodass Sie die Datei build.gradle nicht ändern müssen, um verschiedene Stichproben auszuführen.

Codebeispiel ausführen

Verwenden Sie den folgenden Befehl, um das Beispiel auszuführen:

  gradle -q run

Im Beispiel sollte Ihre API-Anfrage ausgeführt und die Antwort an STDOUT ausgegeben werden. Sie können auch den Dienst aufrufen, den Sie aufrufen, um die Auswirkungen von Anfragen zu sehen, bei denen Daten geschrieben werden.

Node.js

Voraussetzungen

• Node.js

• Die Google APIs-Clientbibliothek für Node.js:

  • Wenn Sie die Clientbibliothek noch nicht installiert haben, führen Sie den folgenden Befehl aus:

  npm install googleapis --save
  

  • Wenn Sie die Clientbibliothek bereits installiert haben, sollten Sie darauf achten, dass Sie die aktuellen Klassen für die zu testende Bibliothek verwenden. Führen Sie den folgenden Befehl aus, um die Clientbibliothek zu aktualisieren:

  npm update googleapis --save
  

Einrichten

1. Folgen Sie der Anleitung in der API-Dokumentation, um ein Projekt für Ihre Anwendung zu erstellen oder auszuwählen und die API zu aktivieren.
2. Abhängig davon, auf welche Art von Daten die Methode zugreift, erstellen Sie einen API-Schlüssel (öffentliche Daten) oder eine OAuth 2.0-Client-ID (private Daten).
3. Wählen Sie als Anwendungstyp Desktop-App aus.
4. Wenn Sie eine OAuth 2.0-Client-ID erstellt haben, laden Sie die JSON-Datei mit Ihren OAuth 2.0-Anmeldedaten herunter. Diese Datei hat einen Namen wie client_secret_CLIENTID.json, wobei CLIENTID die Client-ID für Ihr Projekt ist.
5. Kopieren Sie das Codebeispiel in eine lokale Datei und ändern Sie das Beispiel so, dass der API-Schlüssel oder die Clientschlüsseldatei richtig identifiziert wird. Im Beispiel lautet der Wert des API-Schlüssels YOUR_API_KEY und der Speicherort der Clientschlüsseldatei YOUR_CLIENT_SECRET_FILE.json.

Codebeispiel ausführen

Verwenden Sie den folgenden Befehl, um das Beispiel auszuführen:

  node sample.js

In den meisten Beispielen wird eine API-Antwort (oder etwas anderes) an STDOUT ausgegeben.

PHP

Voraussetzungen

• PHP 5.4 oder höher mit der Befehlszeile und der JSON-Erweiterung.
• Das Composer-Abhängigkeitsmanagement-Tool, das weltweit installiert ist.

• Die Google APIs-Clientbibliothek für PHP:

  • Wenn Sie die Clientbibliothek noch nicht installiert haben, führen Sie den folgenden Befehl aus:

    composer require google/apiclient:^2.0
    

  • Wenn Sie die Clientbibliothek zuvor installiert haben, sollten Sie darauf achten, dass Sie die aktuellen Klassen für die zu testende Bibliothek haben. Führen Sie den folgenden Befehl aus, um die Clientbibliothek zu aktualisieren:

    composer update google/apiclient --with-dependencies
    

Codebeispiel ausführen

Verwenden Sie den folgenden Befehl, um das Beispiel auszuführen:

  php sample.php

In den meisten Beispielen wird eine API-Antwort (oder etwas anderes) an STDOUT ausgegeben.

Python

Voraussetzungen

• Python 2.7 oder Python 3.5+
• Paketverwaltungstool „pip“

• Die Google APIs-Clientbibliothek für Python:

  pip install --upgrade google-api-python-client
  

• Die Bibliotheken google-auth-oauthlib und google-auth-httplib2 zur Nutzerautorisierung:

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

Einrichten

1. Folgen Sie der Anleitung in der API-Dokumentation, um ein Projekt für Ihre Anwendung zu erstellen oder auszuwählen und die API zu aktivieren.
2. Abhängig davon, auf welche Art von Daten die Methode zugreift, erstellen Sie einen API-Schlüssel (öffentliche Daten) oder eine OAuth 2.0-Client-ID (private Daten).
3. Wählen Sie als Anwendungstyp Desktop-App aus.
4. Wenn Sie eine OAuth 2.0-Client-ID erstellt haben, laden Sie die JSON-Datei mit Ihren OAuth 2.0-Anmeldedaten herunter. Diese Datei hat einen Namen wie client_secret_CLIENTID.json, wobei CLIENTID die Client-ID für Ihr Projekt ist.
5. Kopieren Sie das Codebeispiel in eine lokale Datei und ändern Sie das Beispiel so, dass der API-Schlüssel oder die Clientschlüsseldatei richtig identifiziert wird. Im Beispiel lautet der Wert des API-Schlüssels YOUR_API_KEY und der Speicherort der Clientschlüsseldatei YOUR_CLIENT_SECRET_FILE.json.

Codebeispiel ausführen

Verwenden Sie den folgenden Befehl, um das Beispiel auszuführen:

  python sample.py

In den meisten Beispielen wird eine API-Antwort (oder etwas anderes) an STDOUT ausgegeben.

Ruby

Voraussetzungen

• Ruby 2.0 oder höher

• Die Google APIs-Clientbibliothek für Ruby:

  gem install google-api-client`
  

Einrichten

1. Folgen Sie der Anleitung in der API-Dokumentation, um ein Projekt für Ihre Anwendung zu erstellen oder auszuwählen und die API zu aktivieren.
2. Abhängig davon, auf welche Art von Daten die Methode zugreift, erstellen Sie einen API-Schlüssel (öffentliche Daten) oder eine OAuth 2.0-Client-ID (private Daten).
3. Wählen Sie als Anwendungstyp Desktop-App aus.
4. Wenn Sie eine OAuth 2.0-Client-ID erstellt haben, laden Sie die JSON-Datei mit Ihren OAuth 2.0-Anmeldedaten herunter. Diese Datei hat einen Namen wie client_secret_CLIENTID.json, wobei CLIENTID die Client-ID für Ihr Projekt ist.
5. Kopieren Sie das Codebeispiel in eine lokale Datei und ändern Sie das Beispiel so, dass der API-Schlüssel oder die Clientschlüsseldatei richtig identifiziert wird. Im Beispiel lautet der Wert des API-Schlüssels YOUR_API_KEY und der Speicherort der Clientschlüsseldatei YOUR_CLIENT_SECRET_FILE.json.

Codebeispiel ausführen

Verwenden Sie den folgenden Befehl, um das Beispiel auszuführen:

  ruby sample.rb

In den meisten Beispielen wird eine API-Antwort (oder etwas anderes) an STDOUT ausgegeben.