Cloud-verwaltete Zugriffsebenen

Hinweis: Google nimmt Bewerbungen für dieses Programm entgegen. Registrieren.

Mit dieser Funktion können Sie Ihre API-Zugriffsebenen von einer Google Cloud Organisation verwalten lassen. Das bietet Ihnen folgende Vorteile:

• Keine Sicherung von Entwicklertokens mehr erforderlich:Der API-Zugriff wird über die Google Cloud-Organisation verwaltet. Sie müssen sich daher nicht mehr um die Sicherung von Entwicklertokens kümmern oder befürchten, dass sie offengelegt werden. Sie können das Entwicklertoken in Ihren API-Aufrufen weglassen, müssen aber weiterhin ein Zugriffstoken senden.

• Separate Google API Console-Projekte für verschiedene Apps:Alle Projekte, die mit der Google Cloud-Organisation verknüpft sind, übernehmen die API-Zugriffsebene der Organisation. So können Sie unter dieser Organisation mehrere Google API Console-Projekte für verschiedene Zwecke erstellen, z. B. für die detaillierte Projektverwaltung, separate Projekte für verschiedene Apps und mehrere Google API Console-Projekte für Ihre Teammitglieder.

• Bessere Kontingentüberwachung und ‑verwaltung: Sie können die API-Nutzung einzelner Projekte überwachen oder die API-Nutzung begrenzen.

Vorbereitung

• Ein genehmigtes Entwicklertoken

  Sie sollten bereits ein genehmigtes Entwicklertoken haben, um diese Option nutzen zu können. Ein vorhandenes Entwicklertoken finden Sie im API-Center in Ihrem Google Ads-Verwaltungskonto. Melden Sie sich an, und rufen Sie dann „Verwaltung“ > „API-Center“ auf. Gehen Sie im API-Center zu „API-Zugriff“ > „Entwicklertoken“.

• Eine Google Cloud-Organisation

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

  Szenario	Schritte
  Sie sind Google Workspace- oder Google Cloud Identity-Kunde.	Wahrscheinlich haben Sie bereits eine Organisationsressource. Sie können prüfen und erstellen sie bei Bedarf.
  Sie verwenden Google Workspace oder Google Cloud Identity nicht.	Registrieren Sie sich für die kostenlose Version von Google Cloud Identity. Erstellen Sie dann Ihre Organisationsressource.
  Keine der oben genannten Optionen funktioniert für Sie.	Erläutern Sie Ihr Szenario, wenn Sie sich für das Pilotprogramm registrieren, und bitten Sie Google, eine Organisationsressource für Sie zu erstellen. Google besitzt und verwaltet diese Organisationsressource kostenlos.

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

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

  Szenario	Schritte
  Sie haben bereits eine Google Cloud-Organisation oder haben eine im vorherigen Schritt erstellt.	Achten Sie darauf, dass sich alle Google API Console-Projekte, in denen Sie die Google Ads API aktiviert haben, unter dieser Organisation befinden. Wenn das nicht der Fall ist, migrieren Sie sie unter die Organisation. Wenn Sie ein bestehender Google Workspace- oder Google Cloud Identity-Kunde sind, befinden sich die Google API Console-Projekte wahrscheinlich bereits unter Ihrer Organisation, sodass Sie diesen Schritt überspringen können.
  Sie haben keine Google Cloud-Organisation und konnten im vorherigen Schritt keine erstellen.	Achten Sie darauf, dass Sie sowohl Administratornutzer in Ihrem Google Ads API-Verwaltungskonto als auch in Ihrem Google API Console-Projekt sind. Sie benötigen diese Berechtigung, um weitere Schritte nach der Genehmigung Ihres Antrags auf Teilnahme am Pilotprojekt auszuführen.

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

  Achten Sie darauf, dass Ihre E-Mail-Adresse für den Google Ads API-Kontakt auf dem neuesten Stand ist. Die Kontaktdaten für die API finden Sie auf der Seite „API-Center“ Ihres Google Ads API-Verwaltungskontos. Melden Sie sich an und rufen Sie TOOLS & EINSTELLUNGEN > EINRICHTUNG > API-Center auf.

Für das Pilotprogramm registrieren

Registrieren Sie sich für das Pilotprogramm. Das Google Compliance-Team prüft Ihre Bewerbung und sendet eine E-Mail an Ihre E-Mail-Adresse für den API-Kontakt mit dem Freigabestatus und weiteren Details.

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

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

2. Google sendet eine E-Mail mit den Details der neu erstellten Organisationsressource an Ihre E-Mail-Adresse für den API-Kontakt.

3. Sie müssen sich in Ihrem Google API Console-Konto anmelden und der Anleitung folgen, um Ihr Google API Console-Projekt unter die neue Organisation zu verschieben.

4. Antworten Sie auf die E-Mail, um Google mitzuteilen, dass Ihre Projekte unter die neue Organisation verschoben wurden.

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

API-Anfragen ändern

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

Java

Demnächst verfügbar!

.NET

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

Ändern Sie dann Ihren Code so:

// 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 Header developer-token in Ihren HTTP-Anfragen weg:

curl -i -X POST https://googleads.googleapis.com/v24/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

Hier finden Sie einige häufig gestellte Fragen zu Cloud-verwalteten Zugriffsebenen.

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 Sie auf verschiedene Arten erhalten können. Diese Anforderung ähnelt der, dass Sie ein Google API Console-Projekt benötigen, um die Google Ads API zu verwenden.

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

Verwenden Sie vorerst weiterhin das API-Center, um Änderungen an den API-Zugriffsebenen anzufordern.

Gibt es Ausfallzeiten, wenn ich an diesem Pilotprogramm teilnehme?

Nein. Die Google Ads API verwendet automatisch die API-Zugriffsebenen auf Organisationsebene, sobald sie genehmigt wurde.

Wie viel Aufwand ist mit der Teilnahme an diesem Pilotprogramm verbunden?

Es sind nur minimale Codeänderungen erforderlich. Die meisten Entwickler sollten die Änderungen an ihrer App in weniger als 30 Minuten vornehmen können.

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

Im Allgemeinen nicht. Ihnen werden keine Kosten in Rechnung gestellt, wenn Sie an diesem Pilotprogramm teilnehmen. Die Google Ads API wird kostenlos angeboten und Google ändert nichts am Preismodell der Google Ads API.

Es gibt folgende mögliche Szenarien, um eine Google Cloud-Organisation zu erhalten:

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

   Für die reguläre Nutzung dieser Produkte werden Ihnen wie gewohnt Kosten in Rechnung gestellt. Für die Erstellung einer Google Cloud-Organisation zur Teilnahme an diesem Pilotprogramm werden Ihnen keine Kosten in Rechnung gestellt.

2. Sie haben ein kostenloses Google Cloud Identity-Konto erstellt:

   Für die Registrierung für ein kostenloses Google Cloud Identity-Konto oder für die Erstellung einer Google Cloud-Organisation zur Teilnahme an diesem Pilotprogramm werden Ihnen keine Kosten in Rechnung gestellt.

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

   Dies ist eine von Google verwaltete interne Cloud-Organisationsressource. Ihnen werden daher keine Kosten in Rechnung gestellt.

Ich habe mehrere Entwicklertokens für verschiedene Tools. Welche Auswirkungen hat dieses Pilotprogramm auf mich?

Dieser Anwendungsfall wird nicht unterstützt. Sie können daher nicht an diesem Pilotprogramm teilnehmen.

Hat dies Auswirkungen auf die vorhandene API-Autorisierung für die Konten, die ich mit der Google Ads API verwalte?

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

Ich habe mich für dieses Pilotprogramm registriert und habe ein Problem oder Feedback. Wie erreiche ich den Support?

Wenden Sie sich über die Seite Technischer Support für die API page an das Google Ads API-Team und erläutern Sie das Problem. Geben Sie nach Möglichkeit Details wie Ihre Organisations-ID sowie Anfrage- und Antwortlogs an.