Cloud-verwaltete Zugriffsebenen

Hinweis: Google akzeptiert Bewerbungen für dieses Programm. Registrieren.

Mit dieser Funktion können Ihre API-Zugriffsebenen von einer Google Cloud Organisation verwaltet werden. 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 Senden Ihres Entwicklertokens in Ihren API-Aufrufen überspringen. Ein Zugriffstoken müssen Sie aber weiterhin senden.

• Separate Google API Console-Projekte für verschiedene Apps beibehalten:Jedes Projekt, das mit der Google Cloud-Organisation verknüpft ist, erbt 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.

• Detailliertere 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 zu verwenden. 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-Zugriff sebenen zu bestimmen. Es gibt mehrere Möglichkeiten, eine Google Cloud-Organisation zu erstellen.

  Szenario	Schritte
  Sie sind ein bestehender 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 vorherigen 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, wie folgt 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. Ist das nicht der Fall, 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. In diesem Fall können Sie diesen Schritt überspringen.
  Sie haben keine Google Cloud-Organisation und konnten in vorherigen Schritt keine erstellen	Achten Sie darauf, dass Sie sowohl ein Administratornutzer in Ihrem Google Ads API-Verwaltungskonto als auch in Ihrem Google API Console-Projekt sind. Diese Berechtigung ist erforderlich, um weitere Schritte nach der Genehmigung Ihres Antrags auf Teilnahme am Pilotprojekt auszuführen.

• Eine aktuelle E-Mail-Adresse für API-Kontakte

  Achten Sie darauf, dass Ihre E-Mail-Adresse für Google Ads API-Kontakte 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 API-Kontakte 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 an Ihre E-Mail-Adresse für API-Kontakte mit den Details der neu erstellten Organisationsressource.

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 API-Kontakte 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 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 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 zu verwenden?

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 nimmt keine Änderungen am Preismodell der Google Ads API vor.

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

1. Sie sind ein bestehender 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.