Verificación de identidad del anunciante

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ón

  • Un 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.