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

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

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

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

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

אחזור של סטטוס האימות

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

This example is not yet available in Java; you can take a look at the other languages.
    

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
      

This example is not yet available in PHP; you can take a look at the other languages.
    

This example is not yet available in Python; you can take a look at the other languages.
    

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
      

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:

This example is not yet available in Java; you can take a look at the other languages.
    

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
      

This example is not yet available in PHP; you can take a look at the other languages.
    

This example is not yet available in Python; you can take a look at the other languages.
    

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
      

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 כדי להתחיל סשן אימות חדש.