विज्ञापन देने वाले की पहचान की पुष्टि करना

उपयोगकर्ताओं को सुरक्षित और भरोसेमंद विज्ञापन नेटवर्क उपलब्ध कराने के साथ-साथ, नए नियमों का पालन करने के लिए, 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.V18.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;
}
      

अगर ग्राहक का खाता, विज्ञापन देने वाले की पहचान की पुष्टि करने से जुड़े ज़रूरी कार्यक्रम में रजिस्टर है, तो सेवा IdentityVerification ऑब्जेक्ट की सूची के साथ एक खाली जवाब दिखाती है. रिस्पॉन्स के खाली होने का मतलब है कि ग्राहक खाते के लिए, विज्ञापन देने वाले की पहचान की पुष्टि करना ज़रूरी नहीं है.

Google Ads API सिर्फ़ ADVERTISER_IDENTITY_VERIFICATION प्रोग्राम के साथ काम करता है. इसलिए, सूची में सिर्फ़ वह आइटम होगा.

किसी IdentityVerification ऑब्जेक्ट में ये प्रॉपर्टी होती हैं:

  • IdentityVerificationRequirement, जिसमें पुष्टि की प्रोसेस शुरू करने और उसे पूरी करने की समयसीमा के बारे में बताया गया हो

  • पुष्टि की प्रक्रिया की मौजूदा स्थिति के बारे में बताने वाला एक IdentityVerificationProgress: इसमें, वह यूआरएल भी शामिल हो सकता है जिसका इस्तेमाल करके उपयोगकर्ता, पुष्टि की प्रक्रिया को पूरा कर सकता है.

सत्यापन प्रक्रिया प्रारंभ करें

अगर कोई ग्राहक खाता, विज्ञापन देने वाले के लिए पहचान की पुष्टि करने की ज़रूरी प्रक्रिया के लिए रजिस्टर है —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.V18.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::V18::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

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

यह सिर्फ़ तब काम करेगा, जब पुष्टि करने का कोई दूसरा सेशन शुरू न हुआ हो. पुष्टि करने का सेशन शुरू करने के बाद, GetIdentityVerification को फिर से कॉल करने पर, उपयोगकर्ता को कार्रवाई करने के लिए यूआरएल मिलेगा. इससे वह पुष्टि की प्रक्रिया पूरी कर पाएगा. साथ ही, यूआरएल की समयसीमा खत्म होने का समय भी दिखेगा.

समयसीमा खत्म होने के बाद, पुष्टि करने का नया सेशन शुरू करने के लिए, StartIdentityVerification को फिर से कॉल करें.