Ta funkcja umożliwia zarządzanie poziomami dostępu do interfejsu API w organizacji Google Cloud. Dzięki temu możesz korzystać z tych korzyści:
Nie musisz już zabezpieczać tokenów dewelopera: dostępem do interfejsu API zarządza organizacja Google Cloud, więc nie musisz się już martwić o zabezpieczenie tokenów dewelopera ani o ich wyciek. Możesz pominąć wysyłanie tokena programisty w wywołaniach interfejsu API, ale musisz wysłać token dostępu.
Utrzymywanie oddzielnych projektów w Konsoli interfejsów API Google dla różnych aplikacji: każdy projekt połączony z organizacją Google Cloud dziedziczy poziom dostępu interfejsu API organizacji. Dzięki temu możesz tworzyć w tej organizacji wiele projektów w Konsoli interfejsów API Google na potrzeby szczegółowego zarządzania projektami, oddzielnych projektów dla różnych aplikacji oraz wielu projektów w Konsoli interfejsów API Google dla członków zespołu.
Bardziej szczegółowe monitorowanie i zarządzanie limitem: możesz monitorować wykorzystanie interfejsu API w poszczególnych projektach lub ograniczyć jego użycie.
Wymagania wstępne
Zatwierdzony token programisty
Aby korzystać z tej opcji, musisz mieć już zatwierdzony token programisty. Istniejący token programisty znajdziesz w Centrum API na koncie menedżera Google Ads. Zaloguj się, a następnie kliknij Administracja > Centrum 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 na jego podstawie określa poziomy 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. W razie potrzeby możesz sprawdzić i utworzyć. 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 poprzednich opcji nie pasuje do Twojej sytuacji Wyjaśnij, co się stanie, gdy zarejestrujesz się w programie pilotażowym i poprosisz 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 na potrzeby programu pilotażowego
Musisz przygotować projekty w Konsoli interfejsów API Google, których używasz z interfejsem Google Ads API, na potrzeby programu pilotażowego w ten sposób:
Scenariusz Kroki Masz już organizację Google Cloud lub utworzyłeś ją w poprzednim kroku. Upewnij się, że wszystkie projekty w Konsoli interfejsów API Google, w których włączysz interfejs Google Ads API, znajdują się w tej organizacji. Jeśli tak nie jest, przenieś go do organizacji. Jeśli jesteś klientem Google Workspace lub Google Cloud Identity, projekty w Konsoli interfejsów API Google prawdopodobnie są już dostępne 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. Upewnij się, że jesteś administratorem zarówno na koncie menedżera interfejsu API Google Ads, jak i w projekcie w Konsoli interfejsów API Google. Po zatwierdzeniu aplikacji pilotażowej musisz wykonać dodatkowe czynności. Aktualny adres e-mail do kontaktu w sprawie interfejsu API
Sprawdź, czy adres e-mail do kontaktu w Google Ads API jest aktualny. Informacje kontaktowe dotyczące interfejsu API znajdziesz na stronie Centrum interfejsu API na koncie menedżera interfejsu Google Ads API. Zaloguj się, a potem otwórz NARZĘDZIA I USTAWIENIA > USTAWIENIA > CENTRUM API.
Rejestrowanie się w programie pilotażowym
Zarejestruj się w programie pilotażowym. Zespół ds. zgodności Google sprawdzi Twoje zgłoszenie, a następnie wyśle e-maila na adres kontaktowy podany w przypadku interfejsu API, podając stan zatwierdzenia i dodatkowe informacje.
Jeśli poprosiłeś/poprosiłaś Google o utworzenie organizacji Google Cloud, musisz wykonać kilka dodatkowych czynności:
Google utworzy dla Ciebie zasób organizacji Cloud należący do Google. Wszyscy administratorzy konta menedżera interfejsu API Google Ads otrzymają rolę
roles/resourcemanager.projectCreatorw nowo utworzonej organizacji.Google wyśle e-maila na adres e-mail kontaktowy podany w przypadku interfejsu API z szczegółami utworzonego właśnie zasobu organizacji.
Musisz się zalogować na konto w Konsoli interfejsów API Google i postępować zgodnie z instrukcjami przenoszenia projektu 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ół Google ds. zgodności z przepisami sprawdzi Twoje zgłoszenie i wyśle e-maila na adres kontaktowy podany w usłudze API z informacjami o stanie zatwierdzenia i dodatkowymi szczegółami.
Modyfikowanie żądań do interfejsu API
Możesz zmodyfikować swoją aplikację, aby przestała wysyłać nagłówek developer-token podczas wywoływania interfejsu API. Jest to opcjonalny, ale zalecany krok. Jeśli korzystasz z programu pilotażowego, serwer interfejsu Google Ads API ignoruje parametr developer-token, jeśli jest on wysyłany w ramach żądań interfejsu API.
Java
Już wkrótce!
.NET
Pobierz i zainstaluj bibliotekę Google Ads API w Javie 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/v18/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 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 wiele sposobów. Wymaganie to jest podobne do tego, że do korzystania z interfejsu Google Ads API potrzebny jest 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 używaj Centrum interfejsów API.
Czy w przypadku korzystania z tego programu pilotażowego występują jakieś przerwy w działaniu?
Nie, to niemożliwe. Po zatwierdzeniu interfejs Google Ads API automatycznie zacznie używać poziomów dostępu do interfejsu API na poziomie organizacji.
Jak dużo wysiłku wymaga udział w tym programie pilotażowym?
Oczekuj minimalnych zmian w kodzie. Większość deweloperów powinna być w stanie wprowadzić zmiany w aplikacji w mniej niż 30 minut.
Czy jeśli zdecyduję się na udział w tym programie pilotażowym, będę musiał zapłacić?
Zazwyczaj nie pobieramy opłat za udział w tym programie. Interfejs Google Ads API jest dostępny bezpłatnie, a Google nie wprowadza żadnych zmian w jego modelu cen.
Możliwe scenariusze uzyskania organizacji Google Cloud:
Jesteś obecnym klientem Google Workspace lub Cloud Identity:
Za regularne korzystanie z tych usług będziesz obciążany opłatami w zwykły sposób. Nie zostanie naliczona opłata za utworzenie organizacji Google Cloud na potrzeby udziału w tym programie pilotażowym.
Utworzono przez Ciebie konto Google Cloud Identity w wersji bezpłatnej:
Nie zostanie naliczona opłata za rejestrację konta Google Cloud Identity w wersji bezpłatnej ani za utworzenie organizacji Google Cloud w celu udziału w programie pilotażowym.
Google utworzył dla Ciebie zasób organizacji Cloud:
Jest to wewnętrzny zasób organizacji Cloud zarządzany przez Google, więc nie będziesz za niego obciążany opłatami.
Mam kilka tokenów programisty do 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 wziąć udziału w tym teście.
Czy to wpłynie na dotychczasowe 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 dotyczące kont Google Ads, którymi zarządzasz za pomocą interfejsu Google Ads API.
Uczestniczę w tym programie pilotażowym i mam problem lub opinię. Jak skontaktować się z zespołem pomocy?
Skontaktuj się z zespołem Google Ads API na stronie pomocy technicznej dotyczącej interfejsów API i podaj charakter problemu. Jeśli to możliwe, dołącz informacje takie jak identyfikator organizacji oraz logi żądań i odpowiedzi.