Udostępnione aliasy

Podczas pracy z interfejsem Google Ads API adresy e-mail są używane do zarządzania kontaktami i dostępem w wielu miejscach. Oto najważniejsze z nich:

  • Kontaktowy adres e-mail interfejsu API Google Ads: adres e-mail podany jako osoba kontaktowa w Centrum API interfejsu Google Ads.
  • Adres e-mail konta Google Cloud Console: to adres e-mail z dostępem administratora do konta Google Cloud Console używanego na potrzeby Twojej aplikacji OAuth 2.0.
  • Adresy e-mail kont menedżera Google Ads: adresy e-mail, które mają uprawnienia administratora na kontach Google Ads menedżera, do których masz dostęp za pomocą interfejsu Google Ads API. Generując token odświeżania aplikacji, zwykle uwierzytelniasz aplikację interfejsu Google Ads API za pomocą jednego z tych adresów e-mail.

Zdecydowanie zalecamy korzystanie z udostępnionych aliasów zespołów, aby nie utracić dostępu do tych kont, gdy poszczególni członkowie zespołu zmienią się na inne lub odejdą z firmy. W pozostałej części tego przewodnika znajdziesz omówienie wszystkich adresów e-mail wymienionych wcześniej i dowiesz się, jak zaktualizować je, aby używały wspólnego aliasu zespołu zamiast adresu e-mail pojedynczego użytkownika.

Kontaktowy adres e-mail dla interfejsu API Google Ads

Kontaktowy adres e-mail interfejsu Google Ads API to adres, który podajesz podczas rejestracji w interfejsie Google Ads API. Zadbaj o dostęp do tego aliasu i regularnie monitoruj e-maile wysyłane na ten adres. Google używa tego adresu e-mail do kontaktowania się z Twoim zespołem w trakcie sprawdzania interfejsów API, próśb o sprawdzenie lub w sytuacjach awaryjnych, które wymagają natychmiastowej interwencji. Użyj wspólnego aliasu zespołu jako kontaktowego adresu e-mail, aby cały zespół otrzymał te powiadomienia.

Aby zaktualizować kontaktowy adres e-mail osoby odpowiedzialnej za interfejs API, wykonaj te czynności:

  • Zaloguj się na konto menedżera Google Ads użyte do przesłania prośby o dostęp do interfejsu Google Ads API. Jest to konto, na którym znajduje się Twój token programisty.
  • Kliknij Narzędzia i ustawienia > Centrum interfejsów API.
  • Kliknij strzałkę w sekcji Kontaktowy adres e-mail dotyczący interfejsu API.
  • Zaktualizuj adres e-mail i kliknij przycisk Zapisz.

Konto Google Cloud Console

Projekt Konsola interfejsów API Google zawiera dane logowania OAuth aplikacji i kontroluje dostęp do interfejsu Google Ads API. Aby zapewnić dostęp do tego konta, ustaw udostępniony alias jako właściciela konta.

Aby zaktualizować właściciela projektu w Konsoli interfejsów API Google, wykonaj te czynności:

  • Zaloguj się w Konsoli interfejsów API Google.
  • Wybierz projekt z menu w lewym górnym rogu strony.
  • W menu po lewej stronie kliknij Administracja > Uprawnienia.
  • Kliknij przycisk Przyznaj dostęp.
  • Wpisz udostępniony adres e-mail w sekcji Dodaj podmioty zabezpieczeń.
  • Przypisz rolę Właściciel.
  • Kliknij przycisk Zapisz. Więcej informacji o przyznawaniu i cofaniu dostępu znajdziesz w dokumentacji Google Cloud.

konto menedżera Google Ads

Typową metodą zarządzania kontami przez interfejs Google Ads API jest połączenie wszystkich kont w ramach wspólnego konta menedżera i wywołanie ich interfejsu API za pomocą danych logowania konta menedżera najwyższego poziomu. W tej konfiguracji:

  • Deweloper generuje token odświeżania przy użyciu danych logowania użytkownika, który ma dostęp do konta menedżera Google Ads.
  • Deweloper ustawia nagłówek login_customer_id jako identyfikator klienta konta menedżera Google Ads, a nagłówek customer_id jako identyfikator klienta konta, na które są wysyłane wywołania interfejsu API.

Jednym z potencjalnych ryzyka takiej konfiguracji jest to, że jeśli autoryzowany użytkownik utraci dostęp do konta menedżera Google Ads, token odświeżania straci ważność i wszystkie wywołania interfejsu API zakończą się niepowodzeniem. Aby uniknąć tej sytuacji, możesz zaprosić udostępniony alias e-mail do zarządzania tym kontem menedżera Google Ads z odpowiednimi poziomami dostępu. Użyj tego udostępnionego aliasu e-mail, aby wygenerować token odświeżania do wywoływania interfejsu API.