Reklamveren kimlik doğrulaması

Google, kullanıcılar için güvenli ve güvenilir bir reklam ekosistemi sağlamak ve yeni düzenlemelere uymak amacıyla reklamverenlerin artık bir veya daha fazla doğrulama programını tamamlamasını zorunlu tutuyor.

Bir doğrulama programını tamamlamanız gerekirse doğrulama süreci için bir son tarih belirlenebilir. Son tarih doğrulama işlemi tamamlanmadan geçerse hesabınız duraklatılabilir.

Ayrıca, doğrulama işlemine gerek kalmadan proaktif olarak geçebilirsiniz. IdentityVerificationService, aşağıdakileri yapmanız için yöntemler sunar:

  • Müşteri hesabı için doğrulama sürecinin durumunu, tüm son tarihler de dahil olmak üzere alın.
  • Doğrulama süreci başlatma

Doğrulama durumunu alma

Bir müşteri hesabının reklamveren kimlik doğrulaması sürecinin durumunu öğrenmek için GetIdentityVerification yöntemini çağırın:

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.V16.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;
}
      

Müşteri hesabı zorunlu reklamveren kimlik doğrulama programına kayıtlıysa hizmet, IdentityVerification nesnelerinin listesini içeren boş olmayan bir yanıt döndürür. Boş yanıt, müşteri hesabının reklamveren kimlik doğrulamasından geçmesi gerekmediğini belirtir.

Google Ads API, 16 sürümünden itibaren yalnızca ADVERTISER_IDENTITY_VERIFICATION programını desteklemektedir. Dolayısıyla, listedeki tek öğe bu olacaktır.

Bir IdentityVerification nesnesi aşağıdaki özellikleri içerir:

  • Doğrulama sürecini başlatmak ve tamamlamak için son tarihleri açıklayan bir IdentityVerificationRequirement

  • Doğrulama sürecinin mevcut durumunu açıklayan bir IdentityVerificationProgress: Bu, kullanıcının doğrulama işlemini tamamlaması için gereken işlem URL'sini de içerebilir.

Doğrulama işlemini başlat

Zorunlu reklamveren kimlik doğrulaması programına kayıtlı bir müşteri (GetIdentityVerification) doğrulama işleminin tamamlanması için son tarihi içeren boş olmayan bir yanıt döndürdüyse StartIdentityVerification numaralı telefonu arayarak doğrulama oturumu başlatabilirsiniz:

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.V16.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::V16::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

  $api_client->AdvertiserIdentityVerificationService()
    ->start_identity_verification($request);
}
      

Bu işlem yalnızca devam eden başka bir doğrulama oturumu yoksa başarılı olur. Bir doğrulama oturumu başlattıktan sonra, GetIdentityVerification öğesine yapılan sonraki çağrılar kullanıcının doğrulama sürecini tamamlaması için işlem URL'sini ve işlem URL'sinin geçerlilik süresini döndürür.

Geçerlilik süresi dolduktan sonra yeni bir doğrulama oturumu başlatmak için StartIdentityVerification numaralı telefonu tekrar arayabilirsiniz.