W trosce o zapewnienie użytkownikom bezpiecznego i opartego na zaufaniu ekosystemu reklamowego oraz zapewnienie zgodności z nowymi przepisami Google wymaga teraz od reklamodawców przejścia co najmniej 1 procesu weryfikacji.
Jeśli musisz przejść proces weryfikacji, może mieć ustawiony termin, w jakim należy to zrobić. Jeśli termin nie zostanie ukończony, a weryfikacja nie zostanie zakończona, może zostać wstrzymane.
Możesz też profilaktycznie przejść weryfikację bez konieczności wykonywania innych czynności. IdentityVerificationService
zawiera następujące metody:
- Pobieranie stanu procesu weryfikacji konta klienta wraz z terminami
- Rozpocznij proces weryfikacji
Pobieranie stanu weryfikacji
Aby pobrać stan procesu weryfikacji tożsamości reklamodawcy na koncie klienta, wywołaj metodę GetIdentityVerification
:
Java
This example is not yet available in Java; you can take a look at the other languages.
C#
private static IdentityVerification GetIdentityVerification( GoogleAdsClient client, long customerId) { IdentityVerificationServiceClient identityVerificationService = client.GetService(Services.V18.IdentityVerificationService); try { GetIdentityVerificationResponse response = identityVerificationService.GetIdentityVerification( new GetIdentityVerificationRequest() { CustomerId = customerId.ToString() } ); if (response.IdentityVerification.Count == 0) { return null; } IdentityVerification identityVerification = response.IdentityVerification[0]; string deadline = identityVerification.IdentityVerificationRequirement.VerificationCompletionDeadlineTime; IdentityVerificationProgress identityVerificationProgress = identityVerification.VerificationProgress; Console.WriteLine($"Account {customerId} has a verification completion " + $"deadline of {deadline} and status " + $"{identityVerificationProgress.ProgramStatus} for advertiser identity " + "verification."); return identityVerification; } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; } }
PHP
This example is not yet available in PHP; you can take a look at the other languages.
Python
This example is not yet available in Python; you can take a look at the other languages.
Ruby
def get_identity_verification(client, customer_id) response = client.service.identity_verification.get_identity_verification( customer_id: customer_id ) return nil if response.nil? || response.identity_verification.empty? identity_verification = response.identity_verification.first deadline = identity_verification. identity_verification_requirement. verification_completion_deadline_time progress = identity_verification.verification_progress puts "Account #{customer_id} has a verification completion deadline " \ "of #{deadline} and status #{progress.program_status} for advertiser " \ "identity verification." identity_verification end
Perl
sub get_identity_verification { my ($api_client, $customer_id) = @_; my $response = $api_client->IdentityVerificationService()->get({ customerId => $customer_id }); if (!defined $response->{identityVerification}) { printf "Account %s does not require advertiser identity verification.", $customer_id; return; } my $identity_verification = $response->{identityVerification}[0]; my $deadline = $identity_verification->{identityVerificationRequirement} {verificationCompletionDeadlineTime}; my $identity_verification_progress = $identity_verification->{verificationProgress}; printf "Account %s has a verification completion deadline of %s and status " . "%s for advertiser identity verification.", $customer_id, $deadline, $identity_verification_progress->{programStatus}; return $identity_verification; }
Jeśli konto klienta jest zarejestrowane w obowiązkowym programie weryfikacji tożsamości reklamodawcy, usługa zwraca niepustą odpowiedź zawierającą listę obiektów IdentityVerification
. Pusta odpowiedź oznacza, że konto klienta nie musi przejść weryfikacji tożsamości reklamodawcy.
Interfejs Google Ads API obsługuje tylko program ADVERTISER_IDENTITY_VERIFICATION
, więc będzie to jedyny element na liście.
Obiekt IdentityVerification
zawiera te właściwości:
IdentityVerificationRequirement
opisujący terminy rozpoczęcia i ukończenia procesu weryfikacji.IdentityVerificationProgress
opisujący bieżący stan procesu weryfikacji: może on również zawierać adres URL działania, pod którym użytkownik może ukończyć ten proces.
Rozpocznij proces weryfikacji
Jeśli konto klienta jest zarejestrowane w obowiązkowym programie weryfikacji tożsamości reklamodawcy – aplikacja GetIdentityVerification
zwróciła niepustą odpowiedź z terminem zakończenia procesu weryfikacji, możesz rozpocząć sesję weryfikacji, dzwoniąc pod numer StartIdentityVerification
:
Java
This example is not yet available in Java; you can take a look at the other languages.
C#
private static void StartIdentityVerification(GoogleAdsClient client, long customerId) { IdentityVerificationServiceClient identityVerificationService = client.GetService(Services.V18.IdentityVerificationService); StartIdentityVerificationRequest request = new StartIdentityVerificationRequest() { CustomerId = customerId.ToString(), VerificationProgram = IdentityVerificationProgram.AdvertiserIdentityVerification }; try { identityVerificationService.StartIdentityVerification(request); } catch (GoogleAdsException e) { Console.WriteLine("Failure:"); Console.WriteLine($"Message: {e.Message}"); Console.WriteLine($"Failure: {e.Failure}"); Console.WriteLine($"Request ID: {e.RequestId}"); throw; } }
PHP
This example is not yet available in PHP; you can take a look at the other languages.
Python
This example is not yet available in Python; you can take a look at the other languages.
Ruby
def start_identity_verification(client, customer_id) client.service.identity_verification.start_identity_verification( customer_id: customer_id, verification_program: :ADVERTISER_IDENTITY_VERIFICATION, ) end
Perl
sub start_identity_verification { my ($api_client, $customer_id) = @_; my $request = Google::Ads::GoogleAds::V18::Services::IdentityVerificationService::StartIdentityVerificationRequest ->new({ customerId => $customer_id, verificationProgram => ADVERTISER_IDENTITY_VERIFICATION }); $api_client->AdvertiserIdentityVerificationService() ->start_identity_verification($request); }
Będzie to możliwe tylko wtedy, gdy nie trwa żadna inna sesja weryfikacji. Po rozpoczęciu sesji weryfikacji kolejne wywołania GetIdentityVerification
zwrócą adres URL działania, który użytkownik musi wykonać, aby ukończyć proces weryfikacji, oraz termin wygaśnięcia adresu URL działania.
Po upływie czasu ważności możesz ponownie zadzwonić pod numer StartIdentityVerification
, aby rozpocząć nową sesję weryfikacji.