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

لتوفير منظومة إعلانية متكاملة وآمنة وموثوقة للمستخدمين، والالتزام اللوائح التنظيمية الناشئة، تطلب 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.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;
    }


}
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" تتيح 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.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;
    }
}
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::V17::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. مرة أخرى لبدء جلسة تحقّق جديدة.