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 programisty: dostęp do interfejsu API jest zarządzany przez organizację Google Cloud, więc nie musisz się już martwić o zabezpieczenie tokenów programisty ani o ich wyciek. Możesz pominąć wysyłanie tokena programisty w wywołaniach interfejsu API, ale nadal musisz wysyłać token dostępu.
Zachowaj oddzielne projekty w Konsoli interfejsów API Google dla różnych aplikacji: każdy projekt połączony z organizacją Google Cloud dziedziczy poziom dostępu do interfejsu API tej organizacji. Dzięki temu możesz utworzyć w tej organizacji wiele projektów w Konsoli interfejsów API Google na potrzeby np. 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 ograniczyć jego wykorzystanie.
Wymagania wstępne
Zatwierdzony token programisty
Aby korzystać z tej opcji, musisz mieć zatwierdzony token programisty. Istniejący token programisty znajdziesz w Centrum interfejsów API na koncie menedżera Google Ads. Zaloguj się, a następnie kliknij Administracja > Centrum interfejsów API. W Centrum interfejsów 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. Istnieje kilka sposobów utworzenia organizacji Google Cloud.
Scenariusz Kroki Jesteś obecnym klientem Google Workspace lub Google Cloud Identity Prawdopodobnie masz już zasób organizacji. Możesz sprawdzić i utworzyć go w razie potrzeby. Nie korzystasz z Google Workspace ani z 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 Podczas rejestracji w programie pilotażowym opisz swój scenariusz i poproś Google o utworzenie zasobu organizacji. Google będzie właścicielem tego zasobu organizacji i będzie nim zarządzać bezpłatnie. Przygotuj projekty w Konsoli interfejsów API Google do programu pilotażowego
Musisz przygotować projekty w Konsoli interfejsów API Google, których używasz z interfejsem Google Ads API, do programu pilotażowego w ten sposób:
Scenariusz Kroki Masz już organizację Google Cloud lub utworzyłeś ją w poprzednim kroku Sprawdź, czy wszystkie projekty w Konsoli interfejsów API Google, w których masz włączony interfejs Google Ads API, znajdują się w tej organizacji. Jeśli nie, przenieś je do organizacji. Jeśli jesteś obecnym klientem Google Workspace lub Google Cloud Identity, projekty w Konsoli interfejsów API Google prawdopodobnie znajdują się już w Twojej organizacji, więc możesz pominąć ten krok.
Nie masz organizacji Google Cloud i nie udało Ci się jej utworzyć w poprzednim kroku Sprawdź, czy jesteś administratorem zarówno na koncie menedżera interfejsu Google Ads API , jak 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 kontaktu w sprawie interfejsu API
Sprawdź, czy adres e-mail kontaktu w sprawie interfejsu 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 następnie kliknij 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 e-maila na adres e-mail kontaktu w sprawie interfejsu API z informacją o stanie zatwierdzenia i dodatkowymi szczegółami.
Jeśli poprosisz Google o utworzenie organizacji Google Cloud, musisz wykonać kilka dodatkowych czynności:
Google utworzy dla Ciebie zasób organizacji w chmurze, której właścicielem będzie Google. Wszyscy administratorzy Twojego konta menedżera interfejsu Google Ads API otrzymają rolę
roles/resourcemanager.projectCreatorw nowo utworzonej organizacji.Google wyśle e-maila na adres e-mail kontaktu w sprawie interfejsu API z informacjami o nowo utworzonym zasobie organizacji.
Musisz zalogować się na konto w Konsoli interfejsów API Google i postępować zgodnie z instrukcjami, aby przenieść projekt w Konsoli interfejsów API Google do nowej organizacji.
Odpowiedz na e-maila, aby poinformować Google, że Twoje projekty zostały przeniesione do nowej organizacji.
Zespół ds. zgodności Google sprawdzi Twoje zgłoszenie i wyśle e-maila na adres e-mail kontaktu w sprawie interfejsu API z informacją o stanie zatwierdzenia i dodatkowymi szczegółami.
Modyfikowanie żądań do interfejsu API
Możesz zmodyfikować aplikację, aby przestała wysyłać nagłówek developer-token podczas wywoływania interfejsu API. Jest to opcjonalny, ale zalecany krok. Jeśli bierzesz udział w programie pilotażowym, serwer interfejsu Google Ads API ignoruje token programisty developer-token, jeśli jest on wysyłany w ramach żądań do interfejsu 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/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"Najczęstsze pytania
Oto wybrane 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. To wymaganie jest podobne do tego, że aby korzystać z interfejsu Google Ads API, musisz mieć projekt w Konsoli interfejsów API Google.
Muszę zmienić poziomy dostępu do interfejsu API. Jak to zrobić?
Aby poprosić o zmianę poziomów dostępu do interfejsu API, nadal musisz korzystać z Centrum interfejsów API .
Czy w przypadku przystąpienia do tego programu pilotażowego wystąpią jakieś przestoje?
Nie. 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ść programistów powinna być w stanie wprowadzić zmiany w aplikacji w ciągu 30 minut.
Czy w przypadku przystąpienia do tego programu pilotażowego zostaną naliczone opłaty?
Zasadniczo nie, jeśli przystąpisz do tego programu pilotażowego, nie zostaną naliczone żadne 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:
Jesteś obecnym klientem Google Workspace lub Google Cloud Identity:
Opłaty za zwykłe korzystanie z tych usług będą naliczane jak zwykle. Nie będziesz płacić za utworzenie organizacji Google Cloud na potrzeby udziału w tym programie pilotażowym.
Utworzono bezpłatne konto Google Cloud Identity:
Nie będziesz płacić za rejestrację bezpłatnego konta Google Cloud Identity ani za utworzenie organizacji Google Cloud na potrzeby udziału w tym programie pilotażowym.
Google utworzyło dla Ciebie zasób organizacji w chmurze:
Jest to wewnętrzny zasób organizacji w chmurze zarządzany przez Google, więc nie zostaną naliczone żadne opłaty.
Mam kilka tokenów programisty do 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 ta zmiana wpłynie na istniejące autoryzacje interfejsu API na kontach, którymi zarządzam za pomocą interfejsu Google Ads API?
Nie, ta zmiana nie wpłynie na żadne istniejące autoryzacje interfejsu API na kontach Google Ads, którymi zarządzasz za pomocą interfejsu Google Ads API.
Przystąpiłem(-am) do tego programu pilotażowego i mam problem lub opinię. Jak skontaktować się z zespołem pomocy?
Skontaktuj się z zespołem Google Ads API za pomocą strony pomocy technicznej dotyczącej interfejsu Google Ads API i opisz swój problem. Jeśli to możliwe, podaj szczegóły, takie jak identyfikator organizacji oraz logi żądań i odpowiedzi.