Fehlerbehebung

Video: Sehen Sie sich das Gespräch zur Fehlerbehandlung vom Workshop 2019 an.

Fehler können durch eine falsche Umgebungseinrichtung, deiner Software oder ungültige Eingaben durch einen Nutzer. Unabhängig von der Quelle werden Sie müssen Sie das Problem beheben und entweder Ihren Code korrigieren oder eine Logik zur Verarbeitung Fehler durch den Nutzer. In diesem Leitfaden werden einige Best Practices bei der Fehlerbehebung erläutert. von der Google Ads API zurückgegeben.

Konnektivität sicherstellen

  1. Sie benötigen Zugriff auf die Google Ads API und die korrekte Einrichtung. Wenn Ihr in der Antwort alle HTTP-Fehler zurückgibt, dass Sie über Ihren Code die Dienste erreichen, die Sie nutzen möchten.

  2. Ihre Anmeldedaten sind in Ihr request, damit der um Sie zu authentifizieren. Machen Sie sich mit der Struktur der Google Ads API vertraut. Anfragen und Antworten, insbesondere wenn Sie Anrufe ohne mithilfe der Clientbibliotheken. Jede Clientbibliothek wird mit spezifischen wie Sie Ihre Anmeldedaten in die Konfigurationsdatei aufnehmen können (siehe der README-Datei der Clientbibliothek).

  3. Prüfen Sie, ob Sie die richtigen Anmeldedaten verwenden. Unsere In der Kurzanleitung erfahren Sie, wie Sie die den Sie brauchen. Der folgende Antwortfehler zeigt beispielsweise, dass die Der Nutzer hat ungültige Anmeldedaten für die Authentifizierung gesendet:

    {
  "error": {
    "code": 401,
    "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. Visit https://developers.google.com/identity/sign-in/web/devconsole-project.",
    "status": "UNAUTHENTICATED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.DebugInfo",
        "detail": "Authentication error: 2"
      }
    ]
  }
}

Wenn nach dem Ausführen dieser Schritte immer noch Probleme auftreten, ist es Zeit für eine Untersuchung zur Behebung von Google Ads API-Fehlern.

Problem ermitteln

Die Google Ads API meldet Fehler normalerweise als JSON-Fehlerobjekt, das eine Liste von Fehlern in der Antwort. Diese Objekte liefern einen Fehlercode sowie eine Nachricht, in der erklärt wird, warum es aufgetreten ist. Sie sind Ihre ersten Anzeichen dafür, wo das Problem liegen könnte.

{
  "errors": [
    {
      "errorCode": { "fieldMaskError": "FIELD_NOT_FOUND" },
      "message": "The field mask contained an invalid field: 'keyword/matchtype'.",
      "location": { "operationIndex": "1" }
    }
  ]
}

Alle unsere Clientbibliotheken geben Ausnahmen aus, Fehler in der Antwort kapseln. Das Erfassen dieser Ausnahmen und können Sie die Meldungen in einem Protokoll oder auf einem Bildschirm zur Fehlerbehebung um zu beginnen. Die Integration dieser Informationen mit den anderen protokollierten Ereignissen in Ihrem Anwendung bietet einen guten Überblick darüber, was das Problem auslösen könnte. Sobald Sie den Fehler in den Protokollen gefunden haben, müssen Sie herausfinden, was es bedeutet.

Fehler analysieren

  1. Weitere Informationen finden Sie in den häufigen Fehlern in der die am häufigsten auftretenden Fehler behandelt werden. Es beschreibt die Fehlermeldung, relevante API-Referenzen und wie Sie Probleme vermeiden oder Fehler beheben.

  2. Wenn der Fehler in unserer Dokumentation zu häufigen Fehlern nicht erwähnt wird, Sehen Sie sich unsere Referenzdokumentation an und suchen Sie nach dem Fehlerstring.

  3. Suchen Sie in unseren Supportkanälen nach weiteren Ressourcen. von Entwicklern, die ihre Erfahrungen mit der API teilen. Eine andere Person hat das vorliegende Problem gelöst – und es gelöst –.

  4. Wenn Fehler auftreten, die nicht dokumentiert sind, bringen Sie diese unsere Aufmerksamkeit auf das Forum lenken.

  5. Rufen Sie die Google Ads-Hilfe auf. erhalten Sie Hilfe bei Problemen mit der Validierung oder mit dem Kontolimit: Die Google Ads API übernimmt die Regeln und Einschränkungen des grundlegenden Google Ads-Produkts.

  6. In Blogposts finden Sie gelegentlich ebenfalls nützliche Hinweise zur Fehlerbehebung.

Nachdem Sie den Fehler untersucht haben, sollten Sie die Ursache ermitteln.

Ursache ermitteln

Überprüfen Sie die Ausnahmemeldung, um die Ursache des Fehlers zu ermitteln. Nach der Suche der Antwort, überprüfen Sie die Anfrage auf eine mögliche Ursache. Google Ads API-Fehler Nachrichten enthalten ein fieldPathElements im Feld location des GoogleAdsError, die angibt, wo in der Anfrage ist der Fehler aufgetreten. Beispiel:

{
  "errors": [
    {
      "errorCode": {"criterionError": "CANNOT_ADD_CRITERIA_TYPE"},
      "message": "Criteria type can not be targeted.",
      "trigger": { "stringValue": "" },
      "location": {
        "operationIndex": "0",
        "fieldPathElements": [ { "fieldName": "keyword" } ]
      }
    }
  ]
}

Bei der Fehlerbehebung kann es sein, dass Ihre Anwendung falsche Informationen an die API senden. Wir empfehlen dringend die Verwendung eines interaktiven Entwicklungsumgebung (IDE) wie Eclipse (ein kostenloses und eine Open-Source-IDE, die hauptsächlich zur Entwicklung von Java verwendet wird, anderen Sprachen) verwenden, um Ihnen bei der Fehlerbehebung zu helfen. Damit können Sie Haltepunkte und gehen Sie Ihren Code Zeile für Zeile durch.

Überprüfen Sie, ob die Anfrage mit Ihren Anwendungseingaben übereinstimmt (für Beispiel: Der Name der Kampagne erscheint nicht in der Anfrage. Achten Sie darauf, senden Sie eine Feldmaske die den gewünschten Aktualisierungen entspricht: Die Google Ads API unterstützt eine partielle Aktualisierung. Wenn in einer mutate-Anfrage ein Feld aus der Feldmaske weggelassen wird, bedeutet das, in Ruhe lassen. Wenn Ihre Anwendung ein Objekt abruft, eine Änderung vornimmt, und zurücksendet, schreiben Sie möglicherweise in ein Feld, Updates unterstützt. Überprüfen Sie die Feldbeschreibung in der Referenz , um zu prüfen, ob es Einschränkungen gibt, das Feld aktualisieren.

Hilfe

Es ist nicht immer möglich, das Problem selbst zu identifizieren und zu lösen. Eine Frage im Forum zeigt, Ihre Frage an Tausende von Entwicklern, die möglicherweise mit denselben Problem.

Nehmen Sie möglichst viele Informationen in Ihre Abfragen auf. Dazu gehört beispielsweise Folgendes:

  • Bereinigte JSON-Anfrage und -Antwort. Entfernen Sie sensible wie Ihr Entwickler-Token oder AuthToken.
  • Code-Snippets: Wenn Sie ein sprachspezifisches Problem haben oder um Hilfe bei der Arbeit mit der API anzufordern, fügen Sie ein Code-Snippet ein, erklären, was Sie tun.
  • RequestId. So können die Mitglieder des Google Developer Relations-Teams wenn sie sich an die Produktionsumgebung richten. Mi. empfehlen, die requestId in Ihren Protokollen zu registrieren, die Ausnahmen, die Antwortfehler verkapseln, sowie mehr Kontext als die Anfrage-ID allein.
  • Zusätzliche Informationen wie Laufzeit-/Interpreterversion und Plattform auch bei der Fehlerbehebung nützlich sein.

Problem beheben

Nachdem Sie das Problem identifiziert und eine Lösung gefunden haben, können Sie die entsprechenden Änderungen vornehmen und das Bugfix mit einem Testkonto (bevorzugt) oder in der Produktionsumgebung testen (wenn sich der Programmfehler nur auf Daten in einem bestimmten Produktionskonto bezieht).

Teilen empfohlen

Wenn Sie im Forum eine Frage zu einem Fehler gepostet haben, der zuvor und Sie die Lösung gefunden haben, sollten Sie diese Diskussions-Thread. Wenn Entwickler das nächste Mal das gleiche Problem haben, können sie es lösen .

Nächste Schritte

Bei der Lösung Ihres Problems sind Ihnen bestimmt Möglichkeiten aufgefallen, wie Sie Ihren Code verbessern und derartige Fehler von vornherein vermeiden können.

Die Erstellung guter Einheitentests trägt dazu bei, die Codequalität und -zuverlässigkeit zu verbessern erheblich. Es beschleunigt auch das Testen neuer Änderungen, um sicherzustellen, die vorherige Funktionalität nicht beeinträchtigt haben. Eine gute Strategie zur Fehlerbehandlung ist alle notwendigen Daten für die Fehlerbehebung zusammengetragen.

Zurück
Systemlimits
Weiter
Test