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:

• Adres e-mail do kontaktu w przypadku interfejsu Google Ads API: adres 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 ją 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ą zespół 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. Musisz 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 w przypadku przeglądów interfejsu API, próśb o audyt lub nagłych sytuacji wymagających natychmiastowej uwagi. Jako adres e-mail kontaktowy użyj aliasu udostępnionego zespołu, aby mieć pewność, że te powiadomienia otrzyma cały zespół.

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 zmień e-mail. 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, ustaw udostępniony alias jako 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ć udostępniony alias e-maila do zarządzania tym kontem menedżera Google Ads z odpowiednimi poziomami dostępu. Użyj tego udostępnionego aliasu e-maila, aby wydać token odświeżania do wykonywania wywołań interfejsu API.