Weryfikacja tożsamości reklamodawcy

Aby zapewnić użytkownikom bezpieczny i oparty na zaufaniu ekosystem reklamowy oraz zgodność z nowych przepisów, Google wymaga teraz od reklamodawców procesami weryfikacji.

Jeśli musisz przejść proces weryfikacji, możesz ustawić termin dla procesu weryfikacji. Jeśli termin minął bez weryfikacji konto może zostać wstrzymane.

Możesz też bez konieczności przejść weryfikację. IdentityVerificationService udostępnia metody wykonywania tych czynności:

  • pobierać stan procesu weryfikacji konta klienta; w tym wszelkie terminy
  • Rozpocznij proces weryfikacji

Pobieranie stanu weryfikacji

Aby sprawdzić stan procesu weryfikacji tożsamości reklamodawcy dla konta klienta, wywołaj metodę 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;
    }


}
      

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;
}
      

Jeśli konto klienta jest zarejestrowane przy użyciu obowiązkowej tożsamości reklamodawcy w programie weryfikacyjnym, usługa zwraca niepustą odpowiedź zawierającą listę obiektów IdentityVerification. An pusta odpowiedź oznacza, że konto klienta nie musi przejść procesu weryfikacji weryfikacji tożsamości reklamodawcy.

Od wersji 16 interfejs Google Ads API obsługuje tylko ADVERTISER_IDENTITY_VERIFICATION programu, więc będzie to jedyna pozycja na liście.

Obiekt IdentityVerification ma te właściwości:

  • IdentityVerificationRequirement opisujący terminy do rozpocząć proces weryfikacji i go dokończyć;

  • IdentityVerificationProgress opisujący bieżący stan: procesu weryfikacji. Może on również zawierać adres URL działania wykonywanego przez użytkownika, aby ukończyć proces weryfikacji.

Rozpocznij proces weryfikacji

Jeśli konto klienta jest zarejestrowane przy użyciu obowiązkowej tożsamości reklamodawcy program weryfikacji – GetIdentityVerification zwrócił(a) niepuste pole z terminem zakończenia procesu weryfikacji, możesz rozpocząć sesję weryfikacyjną za pomocą połączenia 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;
    }
}
      

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::V17::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

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

Jest to możliwe tylko wtedy, gdy nie jest uruchomiona żadna inna sesja weryfikacyjna. po rozpoczęciu sesji weryfikacji kolejne wywołania GetIdentityVerification zwróci URL działania, które użytkownik może wykonać proces weryfikacji i datę ważności adresu URL działania.

Po upływie okresu ważności możesz zadzwonić pod numer StartIdentityVerification aby rozpocząć nową sesję weryfikacji.