Para ofrecer a los usuarios un ecosistema de anuncios seguro y confiable, y satisfacer las reglamentaciones emergentes, Google ahora exige que los anunciantes completen una o varias programas de verificación.
Si debes completar un programa de verificación, es posible que se establezca una fecha límite para el proceso de verificación. Si se pasa la fecha límite sin la verificación finalización, es posible que su cuenta se detenga.
También puede realizar una verificación de forma proactiva sin que se le solicite hacerlo.
La IdentityVerificationService
ofrece métodos para hacer lo siguiente:
- Recuperar el estado del proceso de verificación de la cuenta de un cliente incluidos los plazos
- Inicia un proceso de verificación
Cómo recuperar el estado de verificación
Para recuperar el estado del proceso de verificación de identidad del anunciante de un
cuenta del cliente, llama al 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.
Rita
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; }
Si la cuenta del cliente está inscrita en la identidad del anunciante obligatoria
programa de verificación, el servicio devuelve una respuesta no vacía que contiene un
Lista de objetos IdentityVerification
. Los
respuesta vacía indica que no es necesario que la cuenta del cliente se someta a
la verificación de identidad del anunciante.
A partir de la versión 16, la API de Google Ads solo admite ADVERTISER_IDENTITY_VERIFICATION
programa, por lo que ese sería el único elemento en la lista.
Un objeto IdentityVerification
contiene las siguientes propiedades:
Un
IdentityVerificationRequirement
que describe los plazos para comenzar y completar el proceso de verificaciónUn objeto
IdentityVerificationProgress
que describe el estado actual del el proceso de verificación, que también puede incluir la URL de acción para el usuario. para completar el proceso de verificación.
Iniciar el proceso de verificación
Si la cuenta de un cliente está inscrita en la identidad del anunciante obligatoria
programa de verificación: GetIdentityVerification
devolvió
con una fecha límite para completar el proceso de verificación, puedes comenzar
una sesión de verificación llamando a 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.
Rita
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); }
Esta acción solo se realizará correctamente si no hay otra sesión de verificación en curso.
una vez iniciada una sesión de verificación, las siguientes llamadas
GetIdentityVerification
mostrará la URL de acción para que el usuario la complete.
el proceso de verificación y la fecha y hora de vencimiento de la URL de acción.
Después de que transcurra el tiempo de vencimiento, podrás llamar a StartIdentityVerification
de nuevo para iniciar una nueva sesión de verificación.