Czwartek, 25 czerwca 2026 r.
W ramach zwiększania bezpieczeństwa kont Google Ads interfejs Google Ads API będzie wymagać zatwierdzenia przez wiele osób podczas wykonywania działań związanych z poufnymi danymi. Jest to część szerszej zmiany w Google Ads, która wymaga zatwierdzenia przez wiele osób w celu wykonywania działań związanych z poufnymi danymi na koncie Google Ads. Te ważne aktualizacje zabezpieczeń zaczniemy wdrażać 27 lipca 2026 r. W ciągu najbliższych tygodni zostaną one włączone dla wszystkich użytkowników.
Co się zmienia?
Po wprowadzeniu tej zmiany zachowanie tych wywołań interfejsu API ulegnie zmianie.
Zapraszanie użytkownika
Jeśli używasz metody CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation, aby zaprosić nowego użytkownika do zarządzania kontem Google Ads, interfejs Google Ads API ocenia teraz, czy może być konieczne zatwierdzenie przez wiele osób. W przypadkach, gdy nasze serwery stwierdzą, że wymagane jest sprawdzenie, system wstrzyma standardowy proces i nie wygeneruje od razu CustomerUserAccessInvitation ani nie wyśle e-maila z zaproszeniem. Zamiast tego inicjowany jest zasób MultiPartyAuthReview, a jego nazwa jest podawana w odpowiedzi. Gdy oczekująca prośba zostanie zatwierdzona przez drugiego administratora konta, CustomerUserAccessInvitation zostanie utworzony, a zaproszony użytkownik otrzyma e-maila. Dopóki nie zostanie rozpatrzone, nie można tworzyć nowych zaproszeń dla tego użytkownika.
Aktualizowanie lub anulowanie dostępu użytkownika
Jeśli używasz metody CustomerUserAccessService.MutateCustomerUserAccess, aby dostosować uprawnienia użytkownika za pomocą operacji aktualizacji lub unieważnić dostęp za pomocą operacji usunięcia, interfejs Google Ads API ocenia teraz, czy może być konieczne zatwierdzenie przez wiele osób. W przypadkach, gdy nasze serwery ustalą, że wymagane jest sprawdzenie, interfejs API generuje zasób MultiPartyAuthReview w stanie oczekiwania i zwraca jego nazwę. Twoje zmiany będą w stanie oczekiwania i zostaną wprowadzone dopiero po zatwierdzeniu przez drugiego administratora konta. Nie można zmienić elementu CustomerUserAccess, dopóki nie zostanie zakończone oczekujące sprawdzenie.
Jak zatwierdzić prośbę o zatwierdzenie przez wiele osób?
Oczekujące zaproszenie MultiPartyAuthReview możesz pobrać za pomocą metod GoogleAdsService.Search lub GoogleAdsService.SearchStream, używając tego zapytania GAQL.
SELECT multi_party_auth_review.resource_name, multi_party_auth_review.multi_party_auth_review_id, multi_party_auth_review.creation_date_time, multi_party_auth_review.request_user_email, multi_party_auth_review.operation_type, multi_party_auth_review.justification, multi_party_auth_review.target_resource, multi_party_auth_review.customer_user_access_review.old_customer_user_access, multi_party_auth_review.customer_user_access_review.new_customer_user_access, multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation FROM multi_party_auth_review WHERE multi_party_auth_review.review_status = 'PENDING'
Oczekującą prośbę MultiPartyAuthReview można zatwierdzić lub odrzucić za pomocą żądania do interfejsu API MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Weryfikację musi przeprowadzić drugi administrator, który nie utworzył pierwotnej prośby. Może to być osoba lub konto usługi z uprawnieniami administratora. Oczekującą prośbę o sprawdzenie może wycofać osoba, która ją przesłała.
Co muszę zrobić?
Jeśli Twoja aplikacja korzysta z tych metod, zaktualizuj ją, aby obsługiwała procesy zatwierdzania przez wiele osób przed 27 lipca 2026 r. Dodaliśmy obsługę zatwierdzeń przez wiele osób we wszystkich głównych wersjach interfejsu API (v24.2, v23.3, v22.2 i v21.2). Jeśli używasz oficjalnej biblioteki klienta, pobierz jej najnowszą wersję. Więcej informacji o tych zmianach znajdziesz w poniższych przewodnikach, które zawierają szczegółowe informacje na następujące tematy:
- Różne stany prośby o zatwierdzenie przez wiele osób
- Jak pobrać i sprawdzić prośby o zatwierdzenie przez wiele osób
- Jak obsługiwać prośby o zatwierdzenie przez wiele osób podczas zapraszania użytkowników
- Jak obsługiwać prośby o zatwierdzenie przez wiele osób podczas aktualizowania ról użytkowników lub usuwania dostępu użytkowników.
Jeśli masz pytania lub chcesz porozmawiać o tej aktualizacji, skontaktuj się z nami na serwerze Discord „Google Advertising and Measurement Community”. Jeśli potrzebujesz pomocy technicznej, wejdź na stronę https://support.google.com/google-ads/contact/google_ads_api.
– Anash P. Oommen, zespół ds. interfejsu Google Ads API
Etykiety: authorization, google-ads-api