Fehlerbehebung bei der API-Nutzung

Diese Seite bietet Anwendungsentwicklern einen Überblick über die Probleme 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 aus verschiedenen Umgebungen auf Google APIs zugreifen. Wir empfehlen Entwicklern, in ihren Anwendungen von Google bereitgestellte Clientbibliotheken zu verwenden. Diese Bibliotheken implementieren eine gängige Standardlogik wie Authentifizierung und Listenpaginierung, wodurch der Aufwand für die Entwicklung und häufige Fehler erheblich reduziert werden.

Weitere Informationen finden Sie unter Erläuterung zu Clientbibliotheken.

Erste Schritte

Wenn Sie neu bei Google APIs sind, folgen Sie der Seite Erste Schritte, um die Vorbereitungsschritte für Ihre Anwendung abzuschließen. Sie sollten zuerst den Befehl curl -v verwenden, um Testanfragen an Google APIs zu senden, die Sie verwenden möchten. Damit können Sie mit Google APIs experimentieren, ohne Code schreiben zu müssen. Sie können viele Probleme häufig beheben, bevor Sie mit der echten Anwendungsentwicklung beginnen.

Weitere Informationen finden Sie unter Einstieg.

Fehlerbehebung mit Messwerten

Google APIs bieten kostenlose API-Messwerte, die häufige Aspekte der API-Nutzung decken, einschließlich der Anzahl der Anfragen, von Fehlern, Latenzen, Anfrage- und Antwortgrößen. Sie bieten Ihnen detaillierte Dimensionen zu Anwendungen und Standorten. Entwickler können ungewöhnliche API-Nutzung erkennen und potenzielle Ursachen identifizieren. 400 Fehler können beispielsweise bedeuten, dass eine kürzlich aktualisierte Anwendung logische Fehler aufweist oder eine höhere Anfrage- und Antwortgröße die Anwendungsleistung verlangsamen kann.

Weitere Informationen finden Sie unter Monitoring-API-Nutzung.

Fehlerbehebung mit Logs

Aus Sicherheits- und Datenschutzgründen stellen Google APIs den Anwendungsentwicklern im Allgemeinen keine API-Logs zur Verfügung. Wir empfehlen Anwendungsentwicklern, API-Fehler auf Clientseite zu protokollieren. Sie können die Fehler entweder in einem lokalen Speicher oder in einer Remote-Logging-API wie der Cloud Logging API protokollieren.

Logs enthalten in der Regel mehr Informationen zu Fehlern als Messwerte, z. B. Fehlermeldungen und Fehlerdetails. Sie sind äußerst nützlich und häufig erforderlich, um API-Fehler zu beheben. Wenn Entwickler ein Problem mit ihrer API-Nutzung feststellen, können sie in den Logs nach Fehlermeldungen und Fehlerdetails suchen und anhand dieser Informationen den 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 sind eine gute Informationsquelle für die Fehlerbehebung bei der Verwendung von Google Cloud APIs. Das VPC Service Controls-Probelauffeature generiert beispielsweise Audit-Logs für Administratoren, um die anstehenden 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 die Fehler auf der Seite Fehler im API-Designleitfaden beheben.

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, wie einen erneuten Versuch nach 503-Fehlern oder eine erneute Authentifizierung von Nutzern nach 401-Fehlern.
  • Die Fehlermeldung gibt Anwendungsentwicklern die Möglichkeit, den Fehler zu verstehen und die Anwendungslogik zu beheben.

  • Die Fehlerdetails enthalten zusätzliche Informationen, mit denen die Anwendungen den Fehler programmatisch bearbeiten können.

Weitere Informationen finden Sie auf der Seite Fehler.