Udostępnione aliasy

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

  • E-mail kontaktowy Google Ads API: e-mail podany jako kontakt w Centrum API w interfejsie Google Ads.
  • Adres e-mail konta konsoli Google Cloud: adres e-mail, który ma dostęp administracyjny do konta konsoli Google Cloud używanego do aplikacji OAuth 2.0.
  • Adresy e-mail do konta menedżera Google Ads: adresy e-mail, które mają uprawnienia administratora na kontach menedżera Google Ads, do których masz dostęp za pomocą interfejsu Google Ads API. Gdy generujesz token odświeżania dla aplikacji, zazwyczaj uwierzytelniasz aplikację Google Ads API za pomocą jednego z tych e-maili.

Zdecydowanie zalecamy używanie wspólnych aliasów zespołów, aby nie utracić dostępu do tych kont, gdy poszczególni członkowie zespołu zmienią zespoły lub opuszczą firmę. W dalszej części tego przewodnika omawiamy każdy z wymienionych wcześniej e-maili oraz wyjaśniamy, jak zaktualizować go, aby używać aliasu udostępnionego zespołu zamiast adresu e-mail pojedynczego użytkownika.

Adres e-mail do kontaktu w przypadku interfejsu Google Ads API

Adres e-mail kontaktowy Google Ads API to adres e-mail podany podczas rejestracji w interfejsie Google Ads API. Użytkownik powinien mieć dostęp do tego aliasu i regularnie sprawdzać e-maile wysyłane na ten adres. Google używa tego adresu e-mail do kontaktowania się z Twoim zespołem podczas sprawdzania interfejsu API, próśb o audyt lub nagłych sytuacji w produkcji, które wymagają natychmiastowej uwagi. Jako adres e-mail kontaktowy użyj aliasu udostępnionego zespołu, aby mieć pewność, że powiadomienia będą otrzymywać wszyscy jego członkowie.

Aby zaktualizować adres e-mail kontaktowego interfejsu API:

  1. Zaloguj się na konto menedżera Google Ads.

  2. W lewym dolnym rogu ekranu kliknij Administracja.

  3. W sekcji Ustawienia konta menedżera kliknij Centrum API.

  4. W sekcji Szczegóły dewelopera zapisz adres e-mail do kontaktu w sprawie interfejsu API. Kliknij strzałkę w dół i edytuj e-maila. Kliknij Save (Zapisz).

Konto w konsoli Google Cloud

Projekt w Konsoli interfejsów API Google zawiera dane logowania OAuth Twojej aplikacji i kontroluje dostęp do interfejsu Google Ads API. Aby mieć dostęp do tego konta, nadaj aliasowi wspólnemu uprawnienia właściciela konta.

Aby zaktualizować właściciela projektu w Konsoli interfejsów API Google:

  • Zaloguj się w Konsoli interfejsów API Google.
  • W menu w lewym górnym rogu strony wybierz projekt.
  • W menu po lewej stronie kliknij Administracja > Uprawnienia.
  • Kliknij przycisk Przyznaj dostęp.
  • W sekcji Dodaj osoby główne wpisz adres e-mail współdzielony.
  • Przypisz rolę Właściciel.
  • Kliknij przycisk Zapisz. Więcej informacji o przyznawaniu i odwoływaniu dostępu znajdziesz w dokumentacji Google Cloud.

konto menedżera Google Ads

Typową metodą zarządzania kontami za pomocą interfejsu Google Ads API jest łączenie wszystkich kont z jednym wspólnym kontem menedżera i wykonywanie wywołań interfejsu API na wszystkich kontach za pomocą danych logowania do najwyższego konta menedżera. W tej konfiguracji:

  • Deweloperzy wystawiają token odświeżania, używając 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, do którego wysyłane są wywołania interfejsu API.

Jednym z potencjalnych zagrożeń takiego rozwiązania jest to, że jeśli upoważniony użytkownik utraci dostęp do konta menedżera Google Ads, token odświeżania przestanie być ważny, a wszystkie wywołania interfejsu API będą się nieudolnie kończyć. Aby uniknąć takiej sytuacji, możesz zaprosić do zarządzania tym kontem menedżera Google Ads użytkownika z odpowiednimi poziomami dostępu, który ma udostępniony alias adresu e-mail. Użyj tego udostępnionego aliasu e-maila, aby wydać token odświeżania do wykonywania wywołań interfejsu API.