In der Cloud verwaltete Zugriffsebenen

Mit diesem Feature können Ihre API-Zugriffsebenen von einem Google Cloud-Administrator Organisation und bietet Ihnen folgende Vorteile:

  • Keine Entwickler-Tokens mehr sichern:Der API-Zugriff wird über in der Google Cloud-Organisation, damit Sie sich keine Gedanken mehr Entwickler-Tokens oder gehackt. Sie können das Senden Ihres Entwicklertokens überspringen, API-Aufrufen ausgeführt, obwohl Sie trotzdem ein Zugriffstoken senden müssen.

  • Erstellen Sie separate Google API Console-Projekte für verschiedene Anwendungen: Jedes Projekt, das unter der Google Cloud-Organisation verknüpft ist, übernimmt die API. Zugriffsebene der Organisation. So können Sie mehrere Google API Console-Projekte in dieser Organisation für Zwecke wie Projektmanagement, separate Projekte für verschiedene Anwendungen, und mehrere Google API Console-Projekte für Ihre Teammitglieder.

  • Finer-Kontingentmonitoring und -verwaltung: Sie können die API überwachen. Nutzung einzelner Projekte oder die API-Nutzung beschränken.

Vorbereitung

  • Genehmigtes Entwicklertoken

    Sie sollten bereits ein freigegebenes Entwickler-Token haben, um diese Option verwenden zu können. Ich können Sie auf der Seite API Center Ihrer Google Ads-Verwaltungskonto. Anmelden, navigieren Sie dann zu TOOLS & EINSTELLUNGEN > EINRICHTEN > API-Center.

  • Eine Google Cloud-Organisation

    Die Google Ads API verknüpft Ihr Entwicklertoken mit einer Google Cloud-Organisation und bestimmt damit Ihren API-Zugriff Stufen. Es gibt mehrere Möglichkeiten, eine Google Cloud-Organisation erstellen.

    Szenario Schritte
    Sie sind ein bestehender Google Workspace oder Google Cloud Identity-Kunde Wahrscheinlich besitzen Sie bereits eine Organisationsressource. Sie können Scheck und erstellen Sie eine, falls erforderlich.
    Sie verwenden Google Workspace nicht oder Google Cloud Identity Melden Sie sich für die kostenlose Version von Google Cloud Identity Dann Ihre Organisationsressource erstellen.
    Keine der oben genannten Optionen trifft für Sie zu Erläutern Sie Ihr Szenario, wenn Sie unterschreiben: für das Pilotprojekt bereit und Google bitten, eine Organisationsressource zu erstellen für Sie. Google besitzt und verwaltet diese Organisationsressource zu keinem Zeitpunkt zu laden.

  • Google API Console-Projekte für das Pilotprogramm vorbereiten

    Sie müssen die Google API Console-Projekte vorbereiten, die Sie mit der Google Ads API verwenden. für das Pilotprogramm so an:

    Szenario Schritte
    Sie sind bereits Inhaber einer Google Cloud-Organisation oder haben eine in der vorheriger Schritt Prüfen Sie, ob alle Google API Console-Projekte, für die Sie die API aktiviert haben, Die Google Ads API gehört dieser Organisation an. Ist dies nicht der Fall, migrieren Sie unter der Organisation.

    Wenn Sie bereits Google Workspace oder Google Cloud Identity-Kunde ist, stehen die Chancen gut, dass die Google API Console-Projekte bereits unter Ihrer Organisation, sodass Sie diesen Schritt überspringen können.
    Sie sind nicht Inhaber einer Google Cloud-Organisation und konnten in dieser zum vorherigen Schritt Sie müssen ein Administrator für den Google Ads API-Manager sein. und Ihr Google API Console-Projekt. Du benötigst diese Berechtigung für weitere Schritte ausführen, nachdem Ihr Pilotantrag genehmigt wurde.

  • Eine aktuelle Kontakt-E-Mail-Adresse für die API

    Achten Sie darauf, dass Ihre Kontakt-E-Mail-Adresse für die Google Ads API aktuell ist. Ihr API-Kontakt . Diese sind in Ihrem Google Ads API-Verwaltungskonto auf der Seite "API-Center" aufgeführt. Melde dich an und rufe dann TOOLS auf. und EINSTELLUNGEN > EINRICHTEN > API-Center.

Für das Pilotprogramm anmelden

Melden Sie sich für das Pilotprogramm an. Das Google Compliance-Team Überprüfen Sie dann Ihren Antrag und senden Sie eine E-Mail an Ihre Kontakt-E-Mail-Adresse für die API mit dem Freigabestatus und weitere Details.

Wenn Sie Google gebeten haben, eine Google Cloud-Organisation für Sie zu erstellen, gibt es sind einige zusätzliche Schritte erforderlich:

  1. Google erstellt eine Google-eigene Cloud-Organisationsressource für Sie. Alle erhalten die Administratoren Ihres Google Ads API-Verwaltungskontos Rolle roles/resourcemanager.projectCreator für die neu erstellte Rolle Unternehmen.

  2. Google sendet eine E-Mail an Ihre Kontakt-E-Mail-Adresse für die API mit Details zum neu erstellte Organisationsressource.

  3. Melden Sie sich in Ihrem Google API Console-Konto an und folgen Sie der Anleitung zum Verschieben Ihres Google API Console-Projekts nach in der neuen Organisation.

  4. Antworten Sie auf die E-Mail und teilen Sie Google mit, dass Ihre Projekte in den Ordner in der neuen Organisation.

  5. Das Google Compliance-Team prüft Ihren Antrag und sendet eine E-Mail an Ihre API. Kontakt-E-Mail-Adresse mit dem Freigabestatus und weiteren Details.

API-Anfragen ändern

Sie können Ihre Anwendung so ändern, dass der developer-token-Header nicht mehr gesendet wird, wenn für API-Aufrufe. Dieser Schritt ist optional, wird aber empfohlen. Wenn Sie sich in der Pilotprogramm ausgeführt, ignoriert der Google Ads API-Server die developer-token, wenn sie als Teil der API-Anfragen.

Java

Demnächst verfügbar!

.NET

Laden Sie Version 17.1.0 oder höher der Google Ads API .NET herunter und installieren Sie sie. Bibliothek.

Ändern Sie nun Ihren Code wie folgt:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

Demnächst verfügbar!

Python

Demnächst verfügbar!

Ruby

Demnächst verfügbar!

Perl

Demnächst verfügbar!

HTTP-Client (REST)

Lassen Sie den developer-token-Header in Ihren HTTP-Anfragen weg:

curl -i -X POST https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

Häufig gestellte Fragen

Bedeutet diese Änderung, dass ich Google Workspace- oder Google Cloud-Kunde sein muss, um die Google Ads API verwenden zu können?

Nein. Sie benötigen eine Google Cloud-Organisation, die in vielen Ländern erhältlich ist. Methoden. Diese Anforderung ähnelt der für einen Google API Console-Projekt, um die Google Ads API zu nutzen.

Ich muss meine API-Zugriffsebenen ändern. Wie kann ich das tun?

Sie sollten vorerst weiter das API-Center verwenden, um Änderungen am API-Zugriffsebenen:

Gibt es Ausfallzeiten für die Teilnahme an diesem Pilotprojekt?

Nein. Für die Google Ads API werden automatisch die API-Zugriffsebenen auf Organisationsebene, sobald diese genehmigt wurden.

Wie aufwendig ist die Teilnahme an diesem Pilotprojekt?

Es sind geringfügige Codeänderungen zu erwarten. Die meisten Entwickler sollten um Änderungen an der App in weniger als 30 Minuten abzuschließen.

Werden mir Kosten in Rechnung gestellt, wenn ich an diesem Pilotprojekt teilnehme?

Im Allgemeinen nein, wenn Sie an diesem Pilotprojekt teilnehmen, werden Ihnen keine Kosten in Rechnung gestellt. Google Ads API wird kostenlos angeboten und Google nimmt keine Änderungen an der Google Ads API vor. Preismodell.

Die möglichen Szenarien für den Erwerb einer Google Cloud-Organisation sind folgt:

  1. Sie sind bereits Google Workspace- oder Google Cloud Identity-Kunde:

    Die regelmäßige Nutzung dieser Produkte wird Ihnen wie gewohnt in Rechnung gestellt. Ich werden nicht berechnet, wenn Sie eine Google Cloud-Organisation zum Zweck der an diesem Pilotprojekt teilnehmen.

  2. Sie haben ein Konto in der kostenlosen Version von Google Cloud Identity erstellt:

    Wenn Sie sich für die kostenlose Version von Google Cloud Identity registrieren, werden Ihnen keine Kosten in Rechnung gestellt Konto erstellen oder eine Google Cloud-Organisation zum Zweck der an diesem Pilotprojekt teilnehmen.

  3. Google hat eine Cloud-Organisationsressource für Sie erstellt:

    Dies ist eine von Google verwaltete interne Cloud-Organisationsressource, sodass Sie in Rechnung gestellt.

Ich habe mehrere Entwickler-Tokens für verschiedene Tools. Welche Auswirkungen hat dieses Pilotprojekt auf mich?

Dieser Anwendungsfall wird nicht unterstützt, daher kannst du nicht daran teilnehmen Pilotprojekt.

Wirkt sich dies auf bestehende API-Autorisierungen für die Konten aus, die ich mit der Google Ads API verwalte?

Nein, diese Änderung wirkt sich nicht auf bestehende API-Autorisierungen des Google Ads- Konten, die Sie über die Google Ads API verwalten

Ich habe mich für das Pilotprojekt angemeldet und habe ein Problem oder Feedback. Wie erreiche ich den Support?

Wenden Sie sich über den technischen API-Support an das Google Ads API-Team. und erläutere die Art des Problems. Einschließen wie Ihre Organisations-ID sowie Anfrage- und Antwortprotokolle möglich.