Fehlerbehebung bei der API-Nutzung

Auf dieser Seite erhalten Anwendungsentwickler einen Überblick über die Fehlerbehebung bei der Verwendung von Google APIs und Google Cloud APIs.

Hintergrund

Google APIs sind Netzwerk-APIs, die von Google-Diensten bereitgestellt werden. Anwendungen können über JSON HTTP und gRPC in verschiedenen Umgebungen auf Google APIs zugreifen. Wir empfehlen Entwicklern, die von Google bereitgestellten Clientbibliotheken in ihren Anwendungen zu verwenden. In diesen Bibliotheken wird eine allgemeine Standardformulierungslogik wie die Paginierung implementiert. Dies reduziert den Entwicklungsaufwand und verringert häufige Fehler.

Weitere Informationen finden Sie unter Erläuterung zu Clientbibliotheken.

Erste Schritte

Wenn Sie Google APIs noch nicht kennen, sollten Sie auf der Seite Erste Schritte die entsprechenden Schritte für die Anwendung ausführen. Senden Sie zuerst mit dem Befehl curl -v Testanfragen an die Google APIs, die Sie verwenden möchten. So können Sie mit Google APIs experimentieren, ohne Code schreiben zu müssen. Bevor Sie mit der eigentlichen Anwendungsentwicklung beginnen, können Sie viele Probleme häufig beheben.

Weitere Informationen finden Sie unter Einstieg.

Fehlerbehebung bei Verwendung von Messwerten

Google APIs stellen kostenlose API-Messwerte bereit, die gängige Aspekte der API-Nutzung abdecken, einschließlich Anzahl der Anfragen, Fehler, Latenzen, Anfrage- und Antwortgrößen. Sie bieten detaillierte Dimensionen in Bezug auf Anwendungen und Standorte. Entwickler können ungewöhnlichen API-Nutzung erkennen und mögliche Ursachen identifizieren. Beispielsweise können Fehlercodes über 400 bedeuten, dass eine kürzlich aktualisierte Anwendung einige logische Programmfehler aufweist oder höhere Anfrage- und Antwortgrößen eine zusätzliche Systemlast verursachen.

Weitere Informationen finden Sie unter API-Nutzung überwachen.

Fehlerbehebung bei Verwendung von Logs

Aus Sicherheits- und Datenschutzgründen stellt Google APIs in der Regel keine API-Logs für Anwendungsentwickler bereit. Wir empfehlen Entwicklern von App-Entwicklern, API-Fehler auf der Clientseite zu protokollieren. Sie können die Fehler entweder im lokalen Speicher oder in der Cloud Logging API protokollieren.

Logs enthalten in der Regel weitere Informationen zu Fehlern als Messwerte, z. B. Fehlermeldungen und Fehlerdetails. Diese sind sehr nützlich und werden oft benötigt, um API-Fehler zu beheben. Wenn Entwickler ein Problem mit ihrer API-Nutzung feststellen, können sie die Logs abfragen, um Fehlermeldungen und Fehlerdetails zu finden, und mit den Informationen die Fehler beheben oder den Support kontaktieren.

Cloud-Audit-Logs

Für sicherheitsrelevante Aktivitäten können Google Cloud-Produkte Audit-Logs generieren, die detaillierte Informationen zu den Aktivitäten enthalten. Sie eignen sich hervorragend für die Behebung von Problemen bei der Nutzung von Google Cloud APIs. VPC Service Controls beispielsweise für das Probelaufkontingent generiert Audit-Logs für Administratoren, um die bevorstehenden Richtlinienänderungen zu bewerten.

Weitere Informationen finden Sie unter Cloud-Audit-Logs.

Fehler beheben

Wenn Sie Probleme mit Ihrer Google API-Nutzung haben und die entsprechenden Messwerte und Logs gefunden haben, können Sie auf der Seite Fehler der API-Designanleitung beginnen.

Im Allgemeinen enthält jeder API-Fehler drei Informationen: Fehlercode, Fehlermeldung und Fehlerdetails:

  • Mit dem Fehlercode können Anwendungen den Fehler auf höherer Ebene behandeln, z. B. 401 im Vergleich zu 403.
  • Die Fehlermeldung ermöglicht es Anwendungsentwicklern, den Fehler zu verstehen und die Anwendungslogik manuell zu korrigieren. WARNUNG: Führen Sie keinen Code an die Fehlermädchen durch. Sie können ohne Vorankündigung geändert werden.
  • Die Fehlerdetails enthalten zusätzliche Informationen, mit denen die Anwendungen den Fehler programmatisch verarbeiten können.

Weitere Informationen finden Sie auf der Seite Fehler.