Poziomy dostępu zarządzane w chmurze

Uwaga: Google przyjmuje zgłoszenia do tego programu. Zarejestruj się.

Ta funkcja umożliwia zarządzanie poziomami dostępu do interfejsu API przez organizację Google Cloud, co daje te korzyści:

• Nie musisz już zabezpieczać tokenów dewelopera: dostęp do interfejsu API jest zarządzany przez organizację Google Cloud, więc nie musisz się już martwić o zabezpieczanie tokenów dewelopera ani o ich wyciek. Możesz pominąć wysyłanie tokena programisty w wywołaniach interfejsu API, ale nadal musisz wysyłać token dostępu.

• Utrzymuj oddzielne projekty w Konsoli interfejsów API Google dla różnych aplikacji: każdy projekt połączony w organizacji Google Cloud dziedziczy poziom dostępu do interfejsu API organizacji. Dzięki temu możesz utworzyć w tej organizacji wiele projektów w Konsoli interfejsów API Google, np. na potrzeby szczegółowego zarządzania projektami, oddzielnych projektów dla różnych aplikacji i wielu projektów w Konsoli interfejsów API Google dla członków zespołu.

• Dokładniejsze monitorowanie limitów i zarządzanie nimi: możesz monitorować wykorzystanie interfejsu API w poszczególnych projektach lub ograniczać wykorzystanie interfejsu API.

Wymagania wstępne

• zatwierdzony token programisty;

  Aby użyć tej opcji, musisz mieć zatwierdzony token dewelopera. Istniejący token programisty znajdziesz w Centrum interfejsu API na koncie menedżera Google Ads. Zaloguj się, a potem otwórz kolejno Administracja > Centrum interfejsów API. W Centrum interfejsu API kliknij Dostęp do interfejsu API > Token programisty.

• organizacja Google Cloud,

  Interfejs Google Ads API łączy Twój token programisty z organizacją Google Cloud i używa go do określania poziomów dostępu do interfejsu API. Organizację Google Cloud można utworzyć na kilka sposobów.

  Scenariusz	Kroki
  Jesteś obecnym klientem Google Workspace lub Google Cloud Identity.	Prawdopodobnie masz już zasób Organizacja. Możesz sprawdzić i w razie potrzeby utworzyć taki profil.
  Nie korzystasz z Google Workspace ani Google Cloud Identity.	Zarejestruj się w bezpłatnej wersji Google Cloud Identity. Następnie utwórz zasób organizacji.
  Żadna z powyższych opcji nie działa	Opisz swój scenariusz, gdy zarejestrujesz się w programie pilotażowym, i poproś Google o utworzenie zasobu organizacji. Google będzie właścicielem tego zasobu organizacji i będzie nim zarządzać bezpłatnie.

• Przygotowywanie projektów w Konsoli interfejsów API Google do programu pilotażowego

  Projekty w Konsoli interfejsów API Google, których używasz z interfejsem Google Ads API, musisz przygotować do programu pilotażowego w ten sposób:

  Scenariusz	Kroki
  masz już organizację Google Cloud lub została ona utworzona w poprzednim kroku;	Sprawdź, czy wszystkie projekty w Konsoli interfejsów API Google, w których masz włączony interfejs Google Ads API, należą do tej organizacji. Jeśli tak nie jest, przenieś go do organizacji. Jeśli jesteś obecnym klientem Google Workspace lub Google Cloud Identity, projekty w Konsoli interfejsów API Google prawdopodobnie są już powiązane z Twoją organizacją, więc możesz pominąć ten krok.
  Nie masz organizacji Google Cloud i nie udało Ci się jej utworzyć w poprzednim kroku.	Upewnij się, że jesteś użytkownikiem z uprawnieniami administratora na koncie menedżera interfejsu Google Ads API i w projekcie w Konsoli interfejsów API Google. To uprawnienie jest potrzebne do wykonania dodatkowych czynności po zatwierdzeniu zgłoszenia do programu pilotażowego.

• aktualny adres e-mail do kontaktu w sprawie interfejsu API,

  Sprawdź, czy adres e-mail kontaktu w interfejsie Google Ads API jest aktualny. Dane kontaktowe dotyczące interfejsu API znajdziesz na stronie Centrum interfejsów API na koncie menedżera interfejsu Google Ads API. Zaloguj się, a potem otwórz kolejno NARZĘDZIA I USTAWIENIA > KONFIGURACJA > CENTRUM INTERFEJSÓW API.

Rejestracja w programie pilotażowym

Zarejestruj się w programie pilotażowym. Zespół ds. zgodności Google sprawdzi Twoje zgłoszenie i wyśle na adres e-mail osoby kontaktowej ds. interfejsu API informację o stanie zatwierdzenia oraz dodatkowe szczegóły.

Jeśli poprosisz Google o utworzenie organizacji Google Cloud, musisz wykonać kilka dodatkowych czynności:

1. Google utworzy dla Ciebie zasób organizacji Google Cloud. Wszyscy administratorzy konta menedżera interfejsu Google Ads API otrzymają rolę roles/resourcemanager.projectCreator w nowo utworzonej organizacji.

2. Google wyśle e-maila na adres kontaktowy API z informacjami o nowo utworzonym zasobie organizacji.

3. Musisz zalogować się na konto w Konsoli interfejsów API Google i postępować zgodnie z instrukcjami, aby przenieść projekt z Konsoli interfejsów API Google do nowej organizacji.

4. Odpowiedz na e-maila, aby poinformować Google, że Twoje projekty zostały przeniesione do nowej organizacji.

5. Zespół ds. zgodności Google sprawdzi Twoje zgłoszenie i wyśle e-maila na adres kontaktowy API z informacją o stanie zatwierdzenia i dodatkowymi szczegółami.

Modyfikowanie żądań do interfejsu API

Możesz zmodyfikować aplikację, aby podczas wywoływania interfejsu API nie wysyłała nagłówka developer-token. Jest to opcjonalny, ale zalecany krok. Jeśli bierzesz udział w programie pilotażowym, serwer interfejsu Google Ads API ignoruje parametr developer-token, jeśli jest on wysyłany w ramach żądań API.

Java

Już wkrótce!

.NET

Pobierz i zainstaluj bibliotekę interfejsu Google Ads API.NET w wersji 17.1 .0 lub nowszej.

Następnie zmodyfikuj kod w ten sposób:

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

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

// Make the API calls.
...

PHP

Już wkrótce!

Python

Już wkrótce!

Ruby

Już wkrótce!

Perl

Już wkrótce!

Klient HTTP (REST)

Pomiń nagłówek developer-token w żądaniach HTTP:

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

Najczęstsze pytania

Oto odpowiedzi na najczęstsze pytania dotyczące poziomów dostępu zarządzanych w chmurze.

Czy ta zmiana oznacza, że aby korzystać z interfejsu Google Ads API, muszę być klientem Google Workspace lub Google Cloud?

Nie. Musisz mieć organizację Google Cloud, którą możesz uzyskać na kilka sposobów. Ten wymóg jest podobny do tego, który obowiązuje obecnie w przypadku korzystania z interfejsu Google Ads API, gdzie wymagany jest projekt w Konsoli interfejsów API Google.

Chcę zmienić poziomy dostępu do interfejsu API. Jak to zrobić?

Aby poprosić o wprowadzenie zmian w poziomach dostępu do interfejsu API, nadal korzystaj z Centrum interfejsów API.

Czy w przypadku przystąpienia do tego programu pilotażowego wystąpią jakieś przestoje?

Nie, to niemożliwe. Po zatwierdzeniu interfejs Google Ads API automatycznie zacznie korzystać z poziomów dostępu do interfejsu API na poziomie organizacji.

Ile wysiłku wymaga udział w tym programie pilotażowym?

Spodziewaj się minimalnych zmian w kodzie. Większość deweloperów powinna być w stanie wprowadzić zmiany w aplikacji w niecałe 30 minut.

Czy jeśli wezmę udział w tym programie pilotażowym, zostaną naliczone opłaty?

Ogólnie rzecz biorąc, nie. Jeśli zdecydujesz się wziąć udział w tym programie pilotażowym, nie pobierzemy od Ciebie opłaty. Interfejs Google Ads API jest oferowany bezpłatnie, a Google nie wprowadza żadnych zmian w modelu cenowym interfejsu Google Ads API.

Możliwe scenariusze uzyskania organizacji Google Cloud są następujące:

1. Jesteś obecnym klientem Google Workspace lub Google Cloud Identity:

   Za zwykłe korzystanie z tych produktów będziemy naliczać opłaty jak zwykle. Za utworzenie organizacji Google Cloud na potrzeby udziału w tym programie pilotażowym nie zostaną naliczone żadne opłaty.

2. Masz utworzone konto bezpłatnej wersji Google Cloud Identity:

   Podczas rejestracji konta Google Cloud Identity Free Edition ani tworzenia organizacji Google Cloud na potrzeby udziału w tym programie pilotażowym nie zostaną naliczone żadne opłaty.

3. Google utworzyło dla Ciebie zasób organizacji w Cloud:

   Jest to wewnętrzny zasób organizacji w chmurze zarządzany przez Google, więc nie poniesiesz z tego powodu żadnych opłat.

Mam kilka tokenów dewelopera dla różnych narzędzi. Jak ten program pilotażowy wpłynie na mnie?

Ten przypadek użycia nie jest obsługiwany, więc nie możesz wziąć udziału w tym programie pilotażowym.

Czy ma to wpływ na dotychczasową autoryzację interfejsu API na kontach, którymi zarządzam za pomocą interfejsu Google Ads API?

Nie, ta zmiana nie ma wpływu na żadne dotychczasowe autoryzacje interfejsu API na kontach Google Ads, którymi zarządzasz za pomocą interfejsu Google Ads API.

Mam problem lub opinię dotyczącą tego programu pilotażowego. Jak skontaktować się z zespołem pomocy?

Skontaktuj się z zespołem interfejsu Google Ads API, korzystając ze strony pomocy technicznej dotyczącej interfejsów API, i wyjaśnij, na czym polega problem. W miarę możliwości podaj szczegóły, takie jak identyfikator organizacji oraz logi żądań i odpowiedzi.