Fehlerbehebung

Fehler können durch eine falsche Umgebungseinrichtung, einen Fehler in Ihrer Software oder ungültige Eingaben eines Nutzers verursacht werden. Unabhängig von der Quelle müssen Sie das Problem beheben und entweder Ihren Code korrigieren oder Logik hinzufügen, um den Nutzerfehler zu behandeln. In diesem Leitfaden werden einige Best Practices für die Fehlerbehebung bei Fehlern in der Google Ads API beschrieben.

Verbindung sicherstellen

  1. Prüfen Sie, ob Sie Zugriff auf die Google Ads API haben und die Einrichtung korrekt ist. Wenn in Ihrer Antwort HTTP-Fehler zurückgegeben werden, müssen Sie diese sorgfältig beheben und dafür sorgen, dass Sie die Dienste, die Sie verwenden möchten, über Ihren Code erreichen.

  2. Ihre Anmeldedaten sind in Ihre Anfrage eingebettet, damit die Dienste Sie authentifizieren können. Machen Sie sich mit der Struktur von Google Ads API-Anfragen und ‑Antworten vertraut, insbesondere wenn Sie Aufrufe ohne Verwendung der Clientbibliotheken verarbeiten möchten. Jede Clientbibliothek wird mit einer spezifischen Anleitung geliefert, wie Sie Ihre Anmeldedaten in die Konfigurationsdatei einfügen (siehe README der Clientbibliothek).

  3. Prüfen Sie, ob Sie die richtigen Anmeldedaten verwenden. In unserer Kurzanleitung wird beschrieben, wie Sie das richtige Set erhalten. Das folgende Beispiel für einen Antwortfehler zeigt, dass der Nutzer ungültige Anmeldedaten gesendet hat:

    {
  "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 Sie diese Schritte ausgeführt haben und weiterhin Probleme auftreten, müssen Sie die Google Ads API-Fehler beheben.

Problem ermitteln

In der Google Ads API werden Fehler in der Regel als JSON-Fehlerobjekt gemeldet, das eine Liste von Fehlern in der Antwort enthält. Diese Objekte enthalten einen Fehlercode und eine Meldung, in der erläutert wird, warum der Fehler aufgetreten ist. Sie sind die ersten Hinweise darauf, was das Problem sein könnte.

{
  "errors": [
    {
      "errorCode": { "fieldMaskError": "FIELD_NOT_FOUND" },
      "message": "The field mask contained an invalid field: 'keyword.match_type'.",
      "location": {
        "fieldPathElements": [
          { "fieldName": "operations", "index": 1 }
        ]
      }
    }
  ]
}

Alle unsere Clientbibliotheken lösen Ausnahmen aus, die Fehler in der Antwort kapseln. Diese Ausnahmen abzufangen und die Meldungen in einem Log oder auf einem Bildschirm zur Fehlerbehebung auszugeben, ist ein guter Anfang. Wenn Sie diese Informationen mit den anderen protokollierten Ereignissen in Ihrer Anwendung kombinieren, erhalten Sie einen guten Überblick darüber, was das Problem auslösen könnte. Nachdem Sie den Fehler in den Logs gefunden haben, müssen Sie herausfinden, was er bedeutet.

Fehler recherchieren

  1. In unserer Dokumentation zu häufigen Fehlern finden Sie Informationen zu den am häufigsten auftretenden Fehlern. Sie enthält die Fehlermeldung, relevante API-Referenzen und Informationen dazu, wie Sie den Fehler vermeiden oder beheben können.

  2. Wenn der Fehler nicht in unserer Dokumentation zu häufigen Fehlern aufgeführt ist, sehen Sie in unserer Referenzdokumentation nach dem Fehlerstring.

  3. In unseren Support-Kanälen finden Sie andere Entwickler, die ihre Erfahrungen mit der API teilen. Möglicherweise ist das Problem, das Sie haben, bereits bei anderen aufgetreten und wurde gelöst.

  4. In der Google Ads-Hilfe finden Sie Informationen zur Fehlerbehebung bei Validierungs- oder Kontobeschränkungsproblemen. Die Google Ads API übernimmt die Regeln und Einschränkungen des Google Ads-Kernprodukts.

  5. Blogposts können gelegentlich eine gute Referenz bei der Fehlerbehebung in Ihrer Anwendung sein.

  6. Wenn Fehler auftreten, die nicht dokumentiert sind, wenden Sie sich an den Support.

Nachdem Sie den Fehler untersucht haben, müssen Sie die Ursache ermitteln.

Ursache ermitteln

Sehen Sie sich die Ausnahmenachricht an, um die Ursache des Fehlers zu ermitteln. Sehen Sie sich die Antwort an und prüfen Sie dann die Anfrage auf eine mögliche Ursache. Einige Google Ads API-Fehlermeldungen enthalten fieldPathElements im Feld location von GoogleAdsError, um anzugeben, wo in der Anfrage der Fehler aufgetreten ist. Beispiel:

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

Bei der Fehlerbehebung kann es vorkommen, dass Ihre Anwendung falsche Informationen an die API sendet. Wir empfehlen dringend, einen Debugger in einer integrierten Entwicklungsumgebung (IDE) zu verwenden, um Breakpoints festzulegen, den Code Zeile für Zeile zu durchlaufen und die erstellten Anfrage-Payloads zu prüfen, bevor sie gesendet werden.

Prüfen Sie noch einmal, ob der Antrag mit den Eingaben in Ihrer Anwendung übereinstimmt. Möglicherweise wird der Name der Kampagne nicht in den Antrag übernommen. Senden Sie eine Feldmaske, die den gewünschten Aktualisierungen entspricht. Die Google Ads API unterstützt spärliche Aktualisierungen. Wenn Sie ein Feld in einer Mutate-Anfrage aus der Feldmaske weglassen, bedeutet das, dass die API es nicht ändern soll. Wenn Ihre Anwendung ein Objekt abruft, eine Änderung vornimmt und es zurücksendet, schreiben Sie möglicherweise in ein Feld, das keine Aktualisierung unterstützt. Sehen Sie in der Referenzdokumentation in der Beschreibung des Felds nach, ob es Einschränkungen gibt, wann oder ob Sie das Feld aktualisieren können.

Hilfe

Es ist nicht immer möglich, das Problem selbst zu erkennen und zu beheben. Sie können sich an den Support wenden, um Unterstützung zu erhalten.

Geben Sie in Ihren Anfragen so viele Informationen wie möglich an. Empfohlene Artikel:

  • Bereinigte JSON-Anfrage und -Antwort. Entfernen Sie alle vertraulichen Informationen wie Ihr OAuth-Zugriffstoken, Ihr Aktualisierungstoken, Ihr Entwicklertoken (falls noch in den alten Anfrageheadern enthalten) und Ihre Kunden-IDs.
  • Code-Snippets: Wenn Sie ein sprachspezifisches Problem haben oder Hilfe bei der Verwendung der API benötigen, fügen Sie ein Code-Snippet ein, um zu erläutern, was Sie tun.
  • request-id. So können Mitglieder des Google Developer Relations-Teams Ihre Anfrage finden, wenn sie für die Produktionsumgebung gestellt wurde. Wir empfehlen, die request-id zu protokollieren, die in Antwortheadern oder Ausnahmen enthalten ist, die Antwortfehler enthalten, sowie mehr Kontext als nur die request-id.
  • Zusätzliche Informationen wie die Laufzeit oder Interpreterversion und die Plattform können bei der Fehlerbehebung ebenfalls hilfreich 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).

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.

Durch das Erstellen einer guten Reihe von Unittests lassen sich Codequalität und Zuverlässigkeit erheblich verbessern. Außerdem wird das Testen neuer Änderungen beschleunigt, um sicherzustellen, dass frühere Funktionen nicht beeinträchtigt werden. Eine gute Strategie zur Fehlerbehandlung ist auch wichtig, um alle erforderlichen Daten für die Fehlerbehebung zu erfassen.

Zurück
Systemlimits
Weiter
Tests