Para oferecer um ecossistema de anúncios seguro e confiável aos usuários e obedecer a regulamentações emergentes, o Google agora exige que os anunciantes concluam um ou mais programas de verificação.
Se for necessário concluir um programa de verificação, poderá ser definido um prazo para esse processo. Se o prazo expirar sem a conclusão da verificação, sua conta poderá ser pausada.
Também é possível passar por uma verificação proativa sem que isso seja necessário.
O IdentityVerificationService
oferece métodos para fazer o seguinte:
- Recuperar o status do processo de verificação de uma conta de cliente, incluindo prazos
- Iniciar um processo de verificação
Recuperar o status de verificação
Para recuperar o status do processo de verificação de identidade do anunciante de uma
conta de cliente, chame o método 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.V17.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; }
Se a conta do cliente estiver inscrita no programa obrigatório de verificação
de identidade do anunciante, o serviço vai retornar uma resposta preenchida com uma
lista de objetos IdentityVerification
. Uma
resposta vazia indica que a conta do cliente não precisa passar pela
verificação de identidade do anunciante.
A partir da versão v16, a API Google Ads só é compatível com o programa ADVERTISER_IDENTITY_VERIFICATION
, e por isso esse é o único item da lista.
Um objeto IdentityVerification
contém as seguintes propriedades:
Uma
IdentityVerificationRequirement
descrevendo os prazos para iniciar e concluir o processo de verificação.Uma
IdentityVerificationProgress
que descreve o status atual do processo de verificação. Isso também pode incluir o URL de ação para que o usuário conclua o processo.
Iniciar o processo de confirmação
Se uma conta de cliente estiver inscrita no programa obrigatório de verificação de identidade do anunciante (GetIdentityVerification
tiver retornado uma resposta com prazo para o término do processo de verificação), você poderá iniciar uma sessão chamando 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.V17.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::V17::Services::IdentityVerificationService::StartIdentityVerificationRequest ->new({ customerId => $customer_id, verificationProgram => ADVERTISER_IDENTITY_VERIFICATION }); $api_client->AdvertiserIdentityVerificationService() ->start_identity_verification($request); }
Isso só será bem-sucedido se não houver outra sessão de verificação em andamento.
Depois de iniciar uma sessão de verificação, as chamadas subsequentes para
GetIdentityVerification
retornarão o URL de ação para que o usuário conclua
o processo de verificação e o prazo de validade do URL de ação.
Após o prazo de validade, é possível chamar StartIdentityVerification
novamente para iniciar uma nova sessão de verificação.