APIs Explorer ansehen und eine Methode ausführen

Auf den meisten Dokumentationsseiten ist ein verkürzter APIs Explorer rechts auf dem Bildschirm sichtbar. Wenn APIs Explorer nicht sichtbar ist, klicken Sie auf Jetzt ausprobieren, um die verkürzte Version des APIs Explorers anzeigen zu lassen.

Wenn Jetzt ausprobieren nicht auf der rechten Seite einer Referenzdokumentation angezeigt wird, wird die Methode von APIs Explorer nicht unterstützt. Beispielsweise ist der APIs Explorer nicht mit APIs kompatibel, die Dienstkonten erfordern. Daher wird er auf Dokumentationsseiten für diese APIs nicht angezeigt.

Maximierte Version von APIs Explorer anzeigen

Die erweiterte Version des APIs Explorers enthält cURL, HTTP und möglicherweise weitere Codebeispiele. Klicke auf „Vollbildmodus“ , um die erweiterte Version des APIs Explorers anzusehen.

Hinweis: Zum Ausführen der Codebeispiele müssen Sie Ihre eigenen Autorisierungsanmeldedaten generieren und verwenden. Eine Anleitung zum Erstellen eines Projekts und zum Generieren von Anmeldedaten finden Sie in der Dokumentation der Google API.

Methode ausführen

Mit APIs Explorer können Sie erforderliche Parameter, optionale Parameter und gegebenenfalls einen Anfragetext für API-Methoden eingeben. Bei vielen REST-Methoden wie Listenmethoden müssen Sie nur ein oder zwei Felder ausfüllen, bevor Sie die Methode ausführen können. Für die Methode books.volumes.list der Books API ist beispielsweise nur der Abfrageparameter (q) erforderlich, um Bücher aufzulisten. So probierst du die Methode books.volumes.list aus:

1. Gehen Sie zu books.volumes.list.
2. Wenn der APIs Explorer nicht angezeigt wird, klicken Sie auf Jetzt ausprobieren.
3. Geben Sie in das Feld q den Text Hunger Games (ohne Anführungszeichen oder Sonderzeichen) ein.
4. Scrollen Sie nach unten und klicken Sie auf Ausführen.
5. Optional: Auf dem Anmeldebildschirm von Google werden Sie aufgefordert, ein Google-Konto auszuwählen.
6. Optional: Ein Dialogfeld für die Google-Autorisierung wird angezeigt, wenn Sie Ihre Bücher verwalten möchten. Klicken Sie auf Zulassen. Die Ergebnisse werden unter der Schaltfläche „Ausführen“ angezeigt.

Wenn der APIs Explorer das Ergebnis „200“ anzeigt, war die Methode erfolgreich.

Hinweis: Nachdem Sie dem Autorisierungsbildschirm eine autorisierte Anfrage gesendet haben, kann API Explorer andere Anfragen senden, bis die Anmeldedaten ablaufen. Daher sehen Sie bei jedem nachfolgenden Methodenaufruf nicht den Autorisierungsbildschirm. Weitere Informationen zu Anmeldedaten findest du unter Test mit verschiedenen Anmeldedatentypen und Bereichen.

Probleme mit APIs Explorer beheben

Sie haben einen Fehler vom Typ 401 oder 403 erhalten

Wenn Sie beim Ausführen einer Methode mit APIs Explorer den Fehler 401 oder 403 erhalten, liegt wahrscheinlich ein Problem mit einem der folgenden Probleme vor:

• Sie verwenden den falschen Autorisierungstyp (API-Schlüssel statt OAuth 2.0). Versuchen Sie, den Autorisierungstyp zu ändern.
• Sie verwenden OAuth 2.0, aber den Umfang ist zu stark eingeschränkt. Versuchen Sie es mit einem breiteren Geltungsbereich.

Dialogfeld für die Autorisierung wird nicht angezeigt

APIs Explorer enthält ein Pop-up-Fenster, in dem Sie Zugriff auf Ihre privaten Daten erhalten. Wenn dein Browser Pop-ups blockiert, werden diese Pop-ups nicht angezeigt und du kannst keinen Zugriff gewähren.

Wenn Sie im Autorisierungsdialogfeld auf Zulassen klicken und nichts passiert, ändern Sie die Pop-up-Einstellungen Ihres Browsers, um Pop-ups zu aktivieren.