Udostępnione aliasy

Podczas korzystania z interfejsu Google Ads API istnieje wiele miejsc, w których adresy e-mail są używane do kontaktów i zarządzania dostępem. Najważniejsze z nich to:

• Kontaktowy adres e-mail dotyczący interfejsu API Google Ads: to adres e-mail podany jako kontakt w Centrum API w interfejsie Google Ads.
• Adres e-mail konta konsoli Google Cloud: ten adres ma dostęp administracyjny do konta konsoli Google Cloud używanego na potrzeby aplikacji OAuth 2.0.
• Adresy e-mail konta menedżera Google Ads: są to adresy e-mail z uprawnieniami administratora na kontach Google Ads menedżera, do których masz dostęp za pomocą interfejsu Google Ads API. Gdy generujesz token odświeżania dla swojej aplikacji, zazwyczaj uwierzytelniasz aplikację interfejsu Google Ads API za pomocą jednego z tych adresów e-mail.

Zdecydowanie zalecamy korzystanie ze współdzielonych aliasów zespołów, aby nie utracić dostępu do tych kont, gdy poszczególni członkowie zespołu przełączą się na inne zespoły lub odejdą z firmy. W pozostałej części tego przewodnika znajdziesz więcej informacji o poszczególnych adresach e-mail wymienionych wcześniej oraz o tym, jak zmienić je w taki sposób, aby używał udostępnionego aliasu zespołu zamiast adresu e-mail poszczególnych użytkowników.

Kontaktowy adres e-mail dotyczący interfejsu Google Ads API

Kontaktowy adres e-mail interfejsu Google Ads API to adres, który podajesz podczas rejestracji w interfejsie Google Ads API. Pamiętaj o dostępie do tego aliasu i regularnie sprawdzaj e-maile wysyłane na ten adres. Google używa tego adresu e-mail do kontaktowania się z Twoim zespołem podczas sprawdzania interfejsów API, próśb o kontrolę lub w sytuacjach awaryjnych, które wymagają natychmiastowej reakcji. Użyj udostępnionego aliasu zespołu jako kontaktowego adresu e-mail, aby mieć pewność, że cały zespół otrzymuje 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 złożenia wniosku o dostęp do interfejsu Google Ads API. Jest to konto, na którym znajduje się token programisty.
• Kliknij Narzędzia i ustawienia > Centrum interfejsu API.
• Kliknij strzałkę w sekcji Kontaktowy adres e-mail osoby kontaktowej ds. interfejsu API.
• Zaktualizuj adres e-mail i kliknij przycisk Zapisz.

Konto konsoli Google Cloud

Projekt Konsola interfejsów API Google zawiera dane logowania OAuth Twojej aplikacji i kontroluje dostęp do interfejsu Google Ads API. Zadbaj o dostęp do tego konta, ustawiając 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 unieważnianiu dostępu znajdziesz w dokumentacji Google Cloud.

konto menedżera Google Ads

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

• Deweloper generuje token odświeżania, używając danych logowania użytkownika, który ma dostęp do konta menedżera Google Ads.
• Programista ustawia nagłówek login_customer_id jako identyfikator klienta konta menedżera Google Ads, a nagłówek customer_id jako identyfikator klienta konta, z którym 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ść, a wszystkie wywołania interfejsu API zakończą się niepowodzeniem. Aby uniknąć takiej 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 do wystawiania tokena odświeżania dla wywołań interfejsu API.