Podczas pracy z interfejsem Google Ads API adresy e-mail są używane w wielu miejscach do zarządzania kontaktami i dostępem. Najważniejsze z nich to:
- Kontaktowy adres e-mail interfejsu Google Ads API: adresy e-mail, którym przypisano rolę Właściciel lub Edytujący w projekcie Google Cloud. Google używa ich do wysyłania obowiązkowych powiadomień o usłudze i powiadomień administracyjnych.
- Adres e-mail konta konsoli Google Cloud: adres e-mail, który ma dostęp administratora do projektu w chmurze Google Cloud używanego w aplikacji OAuth 2.0.
- Dostęp do konta menedżera Google Ads: konto usługi (zalecane) lub udostępniony alias e-mail, który ma uprawnienia dostępu do kont menedżera Google Ads, do których dostęp jest uzyskiwany za pomocą interfejsu Google Ads API.
W dalszej części tego przewodnika znajdziesz szczegółowe informacje o każdym z wymienionych wcześniej kont oraz o tym, jak je skonfigurować, aby integracja nie zależała od adresu e-mail konkretnego użytkownika.
Kontaktowy adres e-mail dotyczący interfejsu Google Ads API
Google wysyła powiadomienia administracyjne, aktualizacje dotyczące sprawdzania interfejsu API, prośby o przeprowadzenie kontroli, obowiązkowe ogłoszenia dotyczące usługi i komunikaty alarmowe dotyczące środowiska produkcyjnego na adresy e-mail powiązane z rolami Właściciel i Edytujący w projekcie Google Cloud (zobacz Nowe adresy e-mail do kontaktu w sprawie interfejsu API, ponieważ starsze ustawienie adresu e-mail do kontaktu w Centrum interfejsu API w interfejsie Google Ads zostało wycofane).
Aby zaktualizować kontaktowy adres e-mail i zapewnić, że cały Twój zespół będzie otrzymywać te powiadomienia, przypisz rolę Właściciel lub Edytujący do udostępnionego aliasu zespołu w projekcie Google Cloud i regularnie sprawdzaj e-maile wysyłane na ten alias.
Konto Google Cloud Console
Projekt w konsoli Google Cloud zawiera dane logowania OAuth aplikacji i kontroluje dostęp do interfejsu Google Ads API. Zapewnij dostęp do tego projektu, przyznając udostępnionemu aliasowi zespołu rolę Właściciel (lub Edytujący).
Aby dodać wspólny alias jako właściciela projektu Google Cloud, wykonaj te czynności:
- Zaloguj się w konsoli Google Cloud.
- Wybierz projekt w selektorze projektów u góry strony.
- W menu nawigacyjnym kliknij Administracja > Uprawnienia.
- Kliknij Grant Access (Przyznaj dostęp).
- W sekcji Dodaj podmioty zabezpieczeń wpisz udostępniony adres e-mail w polu Nowe podmioty zabezpieczeń.
- W sekcji Przypisz role kliknij Wybierz rolę i wybierz Podstawowa > Właściciel (lub Podstawowa > Edytujący).
- Kliknij Zapisz. Jeśli przyznasz rolę Właściciel adresowi e-mail spoza organizacji Google Cloud (lub w projekcie bez organizacji), Google Cloud wyśle e-maila z zaproszeniem na udostępniony alias. Zaproszenie musi zostać zaakceptowane, zanim rola zacznie obowiązywać. Więcej informacji o przyznawaniu i odbieraniu dostępu znajdziesz w dokumentacji Cloud.
konto menedżera Google Ads
Typową metodą zarządzania kontami za pomocą interfejsu Google Ads API jest połączenie wszystkich kont w ramach wspólnego konta menedżera i wywoływanie interfejsu API na wszystkich kontach przy użyciu danych logowania do konta menedżera najwyższego poziomu. W tej konfiguracji deweloper ustawia nagłówek żądania login-customer-id (lub ustawienie konfiguracji biblioteki klienta login_customer_id) na 10-cyfrowy identyfikator klienta (bez łączników) konta menedżera Google Ads, a docelowy customer_id na konto operacyjne, na którym są wykonywane wywołania interfejsu API.
Zalecane: używanie konta usługi
Używanie konta usługi jest preferowanym sposobem uwierzytelniania i uzyskiwania dostępu do konta menedżera Google Ads. W przeciwieństwie do kont poszczególnych użytkowników konto usługi jest zarządzane w projekcie Google Cloud i nie jest powiązane z konkretną osobą, co zapobiega przerwom w działaniu, gdy członkowie zespołu zmieniają role lub odchodzą z firmy. Postępuj zgodnie z przewodnikiem po kontach usługi, aby utworzyć konto usługi i przyznać mu dostęp do konta menedżera Google Ads.
Alternatywa: używanie współdzielonego aliasu e-mail
Jeśli Twoja integracja nie może korzystać z konta usługi i zamiast tego opiera się na procesie uwierzytelniania pojedynczego użytkownika, użytkownik mający dostęp do konta menedżera Google Ads wydaje token odświeżania protokołu OAuth 2.0.
Aby uniknąć tej sytuacji podczas korzystania z danych logowania użytkownika:
- Zaproś udostępniony alias e-mail (powiązany z aktywnym kontem Google z włączoną weryfikacją za pomocą klucza dostępu) do zarządzania tym kontem menedżera Google Ads z odpowiednimi poziomami dostępu.
- Zaakceptuj zaproszenie, używając udostępnionego aliasu e-mail.
- Użyj tego współdzielonego aliasu e-mail, aby wygenerować token odświeżania OAuth do wywoływania interfejsu API.