אימות זהות המפרסם

כדי לספק למשתמשים סביבה עסקית בטוחה ומהימנה וכדי לציית לתקנות החדשות, Google דורשת מהמפרסמים להשלים תוכנית אימות אחת או יותר.

אם התבקשתם להשלים תוכנית אימות, יכול להיות שייקבע תאריך יעד לתהליך האימות. אם המועד האחרון לא עבר את תהליך האימות, יכול להיות שהחשבון יושהה.

אפשר גם לעבור אימות באופן יזום בלי שתידרשו לעשות זאת. IdentityVerificationService כולל שיטות לביצוע הפעולות הבאות:

• מאחזרים את הסטטוס של תהליך האימות של חשבון לקוח, כולל תאריכי יעד
• להתחיל תהליך אימות

אחזור סטטוס אימות

כדי לאחזר את הסטטוס של תהליך אימות הזהות של המפרסם בחשבון לקוח, צריך לבצע קריאה ל-method 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 כדי להתחיל סשן חדש של אימות.