Diese Seite wurde von der Cloud Translation API übersetzt.

In der Cloud verwaltete Zugriffsebenen

Mit diesem Feature können Ihre API-Zugriffsebenen von einer Google Cloud-Organisation verwaltet werden. Das hat folgende Vorteile:

Keine Entwicklertokens mehr: Der API-Zugriff wird über die Google Cloud-Organisation verwaltet. Sie müssen also keine Entwicklertokens mehr schützen oder Datenlecks vermeiden. Sie können das Senden Ihres Entwicklertokens in Ihren API-Aufrufen überspringen, müssen aber trotzdem ein Zugriffstoken senden.
Separate Google API Console-Projekte für verschiedene Anwendungen verwalten: Jedes Projekt, das unter der Google Cloud-Organisation verknüpft ist, übernimmt die API-Zugriffsebene der Organisation. Auf diese Weise können Sie in dieser Organisation mehrere Google API Console-Projekte für Zwecke wie eine detaillierte Projektverwaltung, separate Projekte für verschiedene Anwendungen und mehrere Google API Console-Projekte für Ihre Teammitglieder erstellen.
Überwachung und Verwaltung detaillierter Kontingente: Sie können die API-Nutzung einzelner Projekte überwachen oder die API-Nutzung begrenzen.

Voraussetzungen

Genehmigtes Entwickler-Token

Sie müssen bereits ein genehmigtes Entwicklertoken haben, um diese Option verwenden zu können. Ein vorhandenes Entwicklertoken finden Sie in Ihrem Google Ads-Verwaltungskonto auf der Seite API-Center. Melden Sie sich an und rufen Sie TOOLS UND EINSTELLUNGEN > EINRICHTUNG > API-Center auf.

Eine Google Cloud-Organisation

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

Szenario	Schritte
Sie sind bereits Google Workspace- oder Google Cloud Identity-Kunde	Wahrscheinlich besitzen Sie bereits eine Organisationsressource. Sie können die Prüfen und bei Bedarf erstellen.
Sie verwenden weder Google Workspace noch Google Cloud Identity	Registrieren Sie sich für die kostenlose Version von Google Cloud Identity. Erstellen Sie anschließend Ihre Organisationsressource.
Keine der oben genannten Optionen kommt für Sie infrage	Erläutern Sie Ihr Szenario, wenn Sie sich für das Pilotprojekt registrieren und Google bitten, eine Organisationsressource für Sie zu erstellen. Diese Organisationsressource wird von Google kostenlos verwaltet.

Google API Console-Projekte für das Pilotprogramm vorbereiten

Bereiten Sie die Google API Console-Projekte, die Sie mit der Google Ads API für das Pilotprogramm verwenden, folgendermaßen vor:

Szenario	Schritte
Sie sind bereits Inhaber einer Google Cloud-Organisation oder haben eine im vorherigen Schritt erstellt	Alle Google API Console-Projekte, für die Sie die Google Ads API aktiviert haben, müssen sich in dieser Organisation befinden. Ist das nicht der Fall, migrieren Sie sie unter der Organisation. Wenn Sie bereits Google Workspace- oder Google Cloud Identity-Kunde sind, sind die Google API Console-Projekte wahrscheinlich bereits in Ihrer Organisation vorhanden. In diesem Fall können Sie diesen Schritt überspringen.
Sie sind nicht Inhaber einer Google Cloud-Organisation und konnten im vorherigen Schritt keine erstellen	Sie müssen sowohl Administrator Ihres Google Ads API-Verwaltungskontos als auch Ihres Google API Console-Projekts sein. Sie benötigen diese Berechtigung, um weitere Schritte auszuführen, nachdem Ihr Pilotantrag genehmigt wurde.

Szenario

Schritte

Sie sind bereits Inhaber einer Google Cloud-Organisation oder haben eine im vorherigen Schritt erstellt

Alle Google API Console-Projekte, für die Sie die Google Ads API aktiviert haben, müssen sich in dieser Organisation befinden. Ist das nicht der Fall, migrieren Sie sie unter der Organisation.

Wenn Sie bereits Google Workspace- oder Google Cloud Identity-Kunde sind, sind die Google API Console-Projekte wahrscheinlich bereits in Ihrer Organisation vorhanden. In diesem Fall können Sie diesen Schritt überspringen.

Sie sind nicht Inhaber einer Google Cloud-Organisation und konnten im vorherigen Schritt keine erstellen

Sie müssen sowohl Administrator Ihres Google Ads API-Verwaltungskontos als auch Ihres Google API Console-Projekts sein. Sie benötigen diese Berechtigung, um weitere Schritte auszufü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. Ihre API-Kontaktdaten finden Sie in Ihrem Google Ads API-Verwaltungskonto auf der Seite „API-Center“. Melden Sie sich an und gehen Sie zu TOOLS UND EINSTELLUNGEN > EINRICHTUNG > API-Center.

Für das Pilotprogramm registrieren Das Google Compliance-Team prüft dann Ihren Antrag und sendet eine E-Mail mit dem Genehmigungsstatus und weiteren Details an Ihre API-Kontakt-E-Mail-Adresse.

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

Google erstellt für Sie eine Google-eigene Cloud-Organisationsressource. Allen Administratoren Ihres Google Ads API-Verwaltungskontos wird die Rolle roles/resourcemanager.projectCreator in der neu erstellten Organisation gewährt.
Google sendet eine E-Mail mit den Details zur neu erstellten Organisationsressource an Ihre API-Kontakt-E-Mail-Adresse.
Melden Sie sich in Ihrem Google API Console-Konto an und folgen Sie der Anleitung zum Verschieben Ihres Google API Console-Projekts in die neue Organisation.
Antworten Sie auf die E-Mail und teilen Sie Google mit, dass Ihre Projekte in die neue Organisation verschoben werden.
Das Google Compliance-Team prüft Ihren Antrag und sendet eine E-Mail mit dem Genehmigungsstatus und weiteren Details an Ihre Kontakt-E-Mail-Adresse für die API.

API-Anfragen ändern

Sie können die Anwendung so ändern, dass bei API-Aufrufen der developer-token-Header nicht mehr gesendet wird. Dieser Schritt ist optional, wird aber empfohlen. Wenn Sie am Pilotprogramm teilnehmen, ignoriert der Google Ads API-Server developer-token, wenn er als Teil der API-Anfragen gesendet wird.

Java

Bald verfügbar!

.NET

Laden Sie Version 17.1.0 oder höher der .NET-Bibliothek für die Google Ads API herunter und installieren Sie sie.

Ändern Sie als Nächstes Ihren Code wie folgt:

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

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

// Make the API calls.
...

PHP

Bald verfügbar!

Python

Bald verfügbar!

Ruby

Bald verfügbar!

Perl

Bald verfügbar!

HTTP-Client (REST)

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

curl -i -X POST https://googleads.googleapis.com/v16/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 Kunde von Google Workspace oder Google Cloud sein muss, um die Google Ads API nutzen zu können?

Nein. Sie benötigen eine Google Cloud-Organisation, die auf unterschiedliche Weise abgerufen werden kann. Dies ist vergleichbar mit einem Google API Console-Projekt, um die Google Ads API derzeit zu verwenden.

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

Änderungen an den API-Zugriffsebenen sollten Sie vorerst weiterhin über das API-Center anfordern.

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

Nein. Sobald die Google Ads API genehmigt wurde, werden automatisch die API-Zugriffsebenen auf Organisationsebene verwendet.

Wie aufwendig ist die Teilnahme an diesem Pilotprojekt?

Es sind geringfügige Codeänderungen zu erwarten. Die meisten Entwickler sollten Änderungen an ihrer App in weniger als 30 Minuten vornehmen können.

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

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

Folgende Szenarien für den Erwerb einer Google Cloud-Organisation sind möglich:

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

Die normale Nutzung dieser Produkte wird Ihnen wie gewohnt in Rechnung gestellt. Für die Teilnahme an diesem Pilotprojekt fallen keine Kosten für das Erstellen einer Google Cloud-Organisation an.
Sie haben ein Konto für die kostenlose Version von Google Cloud Identity erstellt:

Wenn Sie sich für ein Konto der kostenlosen Version von Google Cloud Identity registrieren oder eine Google Cloud-Organisation für die Teilnahme an diesem Pilotprojekt erstellen, fallen keine Kosten an.
Google hat eine Cloud-Organisationsressource für Sie erstellt:

Da es sich um eine von Google verwaltete interne Cloud-Organisationsressource handelt, werden Ihnen keine Kosten in Rechnung gestellt.

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

Da dieser Anwendungsfall nicht unterstützt wird, können Sie nicht an diesem Pilotprojekt teilnehmen.

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

Nein. Diese Änderung hat keine Auswirkungen auf bestehende API-Autorisierungen für die Google Ads-Konten, die Sie mit der Google Ads API verwalten.

Ich habe an diesem Pilotprojekt teilgenommen und habe ein Problem oder Feedback. Wie erreiche ich den Support?

Wenden Sie sich über die technische Supportseite für die API an das Google Ads API-Team und erläutern Sie die Art des Problems. Geben Sie nach Möglichkeit Details wie Ihre Organisations-ID sowie Anfrage- und Antwortlogs an.