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

उपयोगकर्ताओं को सुरक्षित और भरोसेमंद विज्ञापन नेटवर्क उपलब्ध कराने के साथ-साथ, नए नियमों का पालन करने के लिए, Google चाहता है कि विज्ञापन देने वाले, एक या एक से ज़्यादा पुष्टि कार्यक्रम के तहत अपने खाते की पुष्टि करें.

अगर आपको पुष्टि करने के लिए किसी प्रोग्राम में हिस्सा लेना है, तो पुष्टि की प्रक्रिया पूरी करने के लिए समयसीमा तय की जा सकती है. अगर तय समयसीमा खत्म होने तक पुष्टि नहीं की जाती है, तो आपके खाते पर रोक लगा दी जा सकती है.

आपके पास, पुष्टि करने के लिए अनुरोध किए बिना भी ऐसा करने का विकल्प है. IdentityVerificationService के ज़रिए, ये काम किए जा सकते हैं:

  • किसी ग्राहक खाते के लिए, पुष्टि की प्रोसेस का स्टेटस पाना. इसमें समयसीमा की जानकारी भी शामिल है
  • पुष्टि की प्रक्रिया शुरू करना

पुष्टि की स्थिति देखना

किसी ग्राहक खाते के लिए, विज्ञापन देने वाले की पहचान की पुष्टि करने की प्रोसेस का स्टेटस पाने के लिए, GetIdentityVerification तरीके को कॉल करें:

Java

private IdentityVerification getIdentityVerification(
    long customerId, IdentityVerificationServiceClient identityVerificationServiceClient) {
  GetIdentityVerificationResponse response =
      identityVerificationServiceClient.getIdentityVerification(Long.toString(customerId));
  if (response.getIdentityVerificationCount() == 0) {
    return null;
  }
  IdentityVerification identityVerification = response.getIdentityVerification(0);
  String deadline =
      identityVerification
          .getIdentityVerificationRequirement()
          .getVerificationCompletionDeadlineTime();
  IdentityVerificationProgress progress = identityVerification.getVerificationProgress();
  System.out.printf(
      "Account %d has a verification completion deadline of '%s' and status '%s' for advertiser"
          + " identity verification.%n",
      customerId, deadline, progress.getProgramStatus());
  return identityVerification;
}

      

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

private static function getIdentityVerification(
    int $customerId,
    IdentityVerificationServiceClient $identityVerificationServiceClient
) {
    // Gets an identity verification response.
    $response = $identityVerificationServiceClient->getIdentityVerification(
        GetIdentityVerificationRequest::build($customerId)
    );
    if (empty($response->getIdentityVerification())) {
        return null;
    }

    // Prints some details about the retrieved identity verification.
    /** @var IdentityVerification $identityVerification */
    $identityVerification = $response->getIdentityVerification()->getIterator()->current();
    $deadline = $identityVerification->getIdentityVerificationRequirement()
        ->getVerificationCompletionDeadlineTime();
    $progress = $identityVerification->getVerificationProgress();
    printf(
        "Account %d has a verification completion deadline of '%s' and status '%s' for"
        . " advertiser identity verification.%s",
        $customerId,
        $deadline,
        IdentityVerificationProgramStatus::name($progress->getProgramStatus()),
        PHP_EOL
    );

    return $identityVerification;
}
      

Python

def get_identity_verification(client, customer_id):
    """Retrieves the status of the advertiser identity verification process.

    Args:
        client: An initialized GoogleAdsClient instance.
        customer_id: The client customer ID str.

    Returns:
        either an IdentityVerification instance, or None
    """
    service = client.get_service("IdentityVerificationService")
    response = service.get_identity_verification(customer_id=customer_id)

    # Check if the response contains any indentity verifications. If not, then
    # None will be returned.
    if response.identity_verification:
        identity_verification = response.identity_verification[0]
        deadline = (
            identity_verification.identity_verification_requirement.verification_completion_deadline_time
        )
        progress = identity_verification.verification_progress.program_status

        print(
            f"Account {customer_id} has a verification completion deadline "
            f"of {deadline} and status {progress} for advertiser identity "
            "verification."
        )

        return identity_verification
      

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

private void startIdentityVerification(
    long customerId, IdentityVerificationServiceClient identityVerificationServiceClient) {
  // Sends a request to start the identity verification process.
  identityVerificationServiceClient.startIdentityVerification(
      Long.toString(customerId), IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION);
}
      

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

private static function startIdentityVerification(
    int $customerId,
    IdentityVerificationServiceClient $identityVerificationServiceClient
): void {
    // Sends a request to start the identity verification process.
    $identityVerificationServiceClient->startIdentityVerification(
        StartIdentityVerificationRequest::build(
            $customerId,
            IdentityVerificationProgram::ADVERTISER_IDENTITY_VERIFICATION
        )
    );
}
      

Python

def start_identity_verification(client, customer_id):
    """Starts the identity verification process.

    Args:
        client: An initialized GoogleAdsClient instance.
        customer_id: The client customer ID str.
    """
    service = client.get_service("IdentityVerificationService")
    # Sends a request to start the identity verification process.
    service.start_identity_verification(
        customer_id=customer_id,
        verification_program=client.enums.IdentityVerificationProgramEnum.ADVERTISER_IDENTITY_VERIFICATION,
    )
      

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 को फिर से कॉल किया जा सकता है.