Poziomy dostępu zarządzane przez chmurę

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

Ta funkcja umożliwia zarządzanie poziomami dostępu do interfejsu API przez usługę Google Cloud , co daje Ci następujące korzyści:

• Nie trzeba już zabezpieczać tokenów programisty: dostępem do interfejsu API zarządza się organizacji Google Cloud, dzięki czemu nie musisz się już martwić o bezpieczeństwo. tokenami programisty lub ich wyciekiem. Możesz pominąć wysyłanie tokena programisty za API, ale nadal musisz wysłać token dostępu.

• Przechowuj osobne projekty w Konsoli interfejsów API Google na potrzeby różnych aplikacji: Każdy projekt połączony w ramach organizacji Google Cloud dziedziczy interfejs API poziom dostępu organizacji. Dzięki temu możesz utworzyć wiele projekty w Konsoli interfejsów API Google w ramach tej organizacji, m.in. do celów: szczegółowe zarządzanie projektami, osobne projekty dla różnych aplikacji, oraz wiele projektów w Konsoli interfejsów API Google dla członków Twojego zespołu.

• Monitorowanie limitów i zarządzanie nimi: możesz monitorować interfejs API. wykorzystanie poszczególnych projektów lub ograniczenia w korzystaniu z interfejsu API.

Wymagania wstępne

• Zatwierdzony token programisty

  Aby móc korzystać z tej opcji, musisz mieć już zatwierdzony token programisty. Ty istniejący token programisty można znaleźć na stronie Centrum interfejsów API konto menedżera Google Ads. Zaloguj się, następnie przejdź do opcji NARZĘDZIA & USTAWIENIA > KONFIGURACJA > API Center.

• Organizacja Google Cloud

  Interfejs Google Ads API wiąże Twój token programisty z organizacją Google Cloud i wykorzystuje je do określania dostępu do interfejsu API . Możesz to zrobić na wiele sposobów utworzyć organizację Google Cloud.

  Scenariusz	Kroki
  Jesteś już zarejestrowanym użytkownikiem Google Workspace lub Google Cloud Klient tożsamości	Prawdopodobnie masz już zasób organizacji. Dostępne opcje Czek i utwórz w razie potrzeby.
  Nie używasz Google Workspace lub Google Cloud Identity	Zarejestruj się w wersji bezpłatnej Google Cloud Identity Potem utwórz zasób organizacji.
  Żadna z powyższych opcji nie jest odpowiednia	Opisz swój scenariusz podczas podpisywania się do wdrożenia pilotażowego i poproś Google o utworzenie zasobu dla organizacji. dla Ciebie. Google będzie właścicielem tego zasobu organizacji i nie będzie nim zarządzać ładowania.

• Przygotowywanie projektów w Konsoli interfejsów API Google pod kątem programu pilotażowego

  Musisz przygotować projekty w Konsoli interfejsów API Google, których używasz, korzystając z interfejsu Google Ads API. dla programu pilotażowego:

  Scenariusz	Kroki
  Masz już organizację Google Cloud lub utworzono ją w poprzedni krok	Upewnij się, że we wszystkich projektach Konsoli interfejsów API Google, w których włączono Pod tą organizacją znajduje się interfejs Google Ads API. Jeśli nie, przeprowadź migrację w ramach tej organizacji. Jeśli masz już konto Google Workspace lub Google Cloud Identity, prawdopodobnie projekty w Konsoli interfejsów API Google już należą do Twojej organizacji, więc możesz pominąć ten krok.
  Nie jesteś właścicielem organizacji Google Cloud i nie możesz jej utworzyć w kraju: poprzedni krok	Upewnij się, że jesteś administratorem menedżera interfejsu Google Ads API i projektu w Konsoli interfejsów API Google. Te uprawnienia są potrzebne do: wykonaj dodatkowe czynności po zatwierdzeniu zgłoszenia do programu pilotażowego.

• aktualny kontaktowy adres e-mail osoby odpowiedzialnej za interfejs API.

  Upewnij się, że Twój kontaktowy adres e-mail dotyczący interfejsu Google Ads API jest aktualny. Twoja osoba kontaktowa ds. API podane informacje znajdziesz na stronie Centrum API na koncie menedżera Google Ads API. Zaloguj się i przejdź do sekcji NARZĘDZIA i USTAWIENIA > KONFIGURACJA > API Center.

Rejestrowanie się w programie pilotażowym

Zarejestruj się w programie pilotażowym. Zespół Google ds. zgodności Następnie przejrzyj zgłoszenie i wyślij e-maila na swój kontaktowy adres e-mail ds. interfejsu API oraz stan zatwierdzenia i dodatkowe informacje.

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

1. Google utworzy dla Ciebie zasób organizacji Cloud należący do Google. Wszystkie administratorzy Twojego konta menedżera Google Ads API otrzymają Rola roles/resourcemanager.projectCreator w nowo utworzonym Twojej organizacji.

2. Google wyśle na Twój kontaktowy adres e-mail ds. interfejsu API informacje o nowo utworzony zasób organizacji.

3. Musisz zalogować się na konto Konsoli interfejsów API Google i postępować zgodnie z instrukcje przenoszenia projektu w Konsoli interfejsów API Google pod do nowej organizacji.

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

5. Zespół ds. zgodności Google sprawdzi Twoje zgłoszenie i wyśle Ci e-maila z interfejsem API kontaktowy adres e-mail ze stanem zatwierdzenia i dodatkowymi informacjami.

Modyfikowanie żądań do interfejsu API

Możesz zmodyfikować aplikację, aby przestała wysyłać nagłówek developer-token, gdy: lub wykonywanie wywołań interfejsu API. Jest to jednak opcjonalny, ale zalecany krok. Jeśli jesteś w programu pilotażowego, serwer interfejsu API Google Ads ignoruje developer-token, jeśli zostanie wysłany w jego ramach żądań do interfejsu API.

Java

Już wkrótce!

.NET

Pobierz i zainstaluj wersję 17.1.0 lub nowszą interfejsu Google Ads API .NET Biblioteka.

Następnie zmodyfikuj kod w następujący 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/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"

Najczęstsze pytania

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

Nie. Musisz mieć organizację Google Cloud, którą można uzyskać w wielu krajach . Ten wymóg jest podobny do wymagań projekt w Konsoli interfejsów API Google, aby móc korzystać z interfejsu Google Ads API już dziś.

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

Na razie używaj Centrum API, aby zgłaszać prośby o wprowadzenie zmian w interfejsie Poziomy dostępu interfejsów API.

Czy wyrażenie zgody na udział w tym programie pilotażowym jest możliwe?

Nie, to niemożliwe. Interfejs Google Ads API automatycznie zacznie używać poziomy dostępu do interfejsów API na poziomie organizacji po zatwierdzeniu.

Ile wysiłku wymaga wzięcie udziału w tym programie pilotażowym?

Spodziewaj się minimalnych zmian w kodzie. Większość programistów powinna mieć aby wprowadzić zmiany w aplikacji w mniej niż 30 minut.

Czy poniosę opłaty, jeśli dołączę do tego programu pilotażowego?

Zasadniczo nie, nie pobierzemy żadnych opłat, jeśli zgłosisz się do tego programu pilotażowego. Interfejs Google Ads API jest dostępny bezpłatnie, a Google nie wprowadza żadnych zmian w interfejsie Google Ads API. modelu cenowego.

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

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

   Opłata będzie naliczana jak zawsze za regularne korzystanie z tych usług. Ty nie będą obciążane opłatami za utworzenie organizacji Google Cloud w celu: biorących udział w tym programie.

2. Udało Ci się utworzyć konto Google Cloud Identity Free Edition:

   Jeśli zarejestrujesz się w bezpłatnej wersji Google Cloud Identity, nie obciążymy Cię opłatami lub utworzenie organizacji Google Cloud w celu biorących udział w tym programie.

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

   Jest to zarządzany przez Google wewnętrzny zasób organizacji Cloud, więc nie obciążymy Twojego konta.

Mam wiele tokenów programisty dla różnych narzędzi. Jak ten program pilotażowy wpływa na mnie?

Ten przypadek użycia nie jest obsługiwany, więc nie możesz uczestniczyć w tym programu pilotażowego.

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

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

Po przystąpieniu do programu pilotażowego mam problem lub opinię. Jak skontaktować się z zespołem pomocy?

skontaktować się z zespołem Google Ads API, korzystając z pomocy technicznej dotyczącej interfejsu API. i wyjaśnij charakter problemu. Uwzględnij takie jak identyfikator organizacji oraz dzienniki żądań i odpowiedzi, jak to tylko możliwe.