التحقق من هوية المعلِن

لتوفير منظومة إعلانية متكاملة وآمنة وموثوقة للمستخدمين، والالتزام باللوائح التنظيمية الناشئة، تطلب Google الآن من المعلِنين إكمال برنامج واحد أو أكثر من برامج التحقّق من المعلِنين.

إذا طُلب منك إكمال برنامج التحقّق من المعلِنين، قد يتم تحديد موعد نهائي لعملية التحقّق من المعلنين. وفي حال انقضاء الموعد النهائي بدون إكمال عملية إثبات الملكية، قد يتم إيقاف حسابك مؤقتًا.

يمكنك أيضًا إجراء عملية التحقّق بشكل استباقي بدون الحاجة إلى ذلك. وتقدّم IdentityVerificationService طرقًا لإجراء ما يلي:

  • استرداد حالة عملية التحقق لحساب عميل، بما في ذلك أي مواعيد نهائية
  • بدء عملية إثبات هوية وأهلية المعلِن

استرداد حالة إثبات الملكية

للاطّلاع على حالة عملية إثبات هوية المعلِن لحساب عميل، اتصِل إلى طريقة 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.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;
    }


}
VerifyAdvertiserIdentity.cs

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
verify_advertiser_identity.rb

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;
}
verify_advertiser_identity.pl

إذا كان حساب العميل مسجّلاً في البرنامج الإلزامي للتحقّق من هوية المعلِن، تعرِض الخدمة استجابة غير فارغة تحتوي على قائمة بعناصر IdentityVerification. تشير الإجابة الفارغة إلى أنّ حساب العميل غير ملزم للتحقق من هوية المعلِن.

اعتبارًا من الإصدار 16، لا تتيح Google Ads API سوى استخدام برنامج ADVERTISER_IDENTITY_VERIFICATION، وبالتالي سيكون هذا البرنامج هو العنصر الوحيد في القائمة.

يحتوي عنصر IdentityVerification على السمات التالية:

  • IdentityVerificationRequirement تصف المواعيد النهائية لبدء عملية التحقّق وإكمالها

  • سمة IdentityVerificationProgress تصف الحالة الحالية لعملية إثبات الملكية: ويمكن أن تشمل أيضًا عنوان URL للإجراء المطلوب من المستخدم إكمال عملية إثبات الملكية

بدء عملية التحقق

إذا كان حساب العميل مسجّلاً في البرنامج الإلزامي للتحقّق من هوية المعلِن، أرجع GetIdentityVerification ردًا غير فارغ يتضمّن موعدًا نهائيًا لإكمال عملية التحقّق من المعلِنين، يمكنك بدء جلسة إثبات هوية من خلال الاتصال على الرقم 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.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;
    }
}
VerifyAdvertiserIdentity.cs

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
verify_advertiser_identity.rb

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);
}
verify_advertiser_identity.pl

لن ينجح هذا الإجراء إلا إذا لم تكن هناك جلسة إثبات ملكية أخرى قيد التقدم. بعد بدء جلسة إثبات الملكية، ستعرض الطلبات اللاحقة على GetIdentityVerification عنوان URL للإجراء المطلوب للمستخدم إكمال عملية إثبات الملكية ووقت انتهاء صلاحية عنوان URL الخاص بالإجراء.

بعد انقضاء وقت انتهاء الصلاحية، يمكنك الاتصال بـ StartIdentityVerification مجددًا لبدء جلسة تحقق جديدة.

السابق
تغيير الحدث