Überprüfung der Identität von Werbetreibenden

Wir möchten Nutzern eine sichere und vertrauenswürdige Werbeumgebung bieten und neue Vorschriften einhalten. Aus diesem Grund müssen Werbetreibende jetzt ein oder mehrere Überprüfungsverfahren durchlaufen.

Wenn Sie ein Überprüfungsverfahren durchlaufen müssen, kann eine Frist dafür festgelegt werden. Wenn die Frist ohne Abschluss der Überprüfung verstrichen ist, wird Ihr Konto möglicherweise pausiert.

Sie können die Überprüfung auch proaktiv durchführen, ohne dies selbst tun zu müssen. Mit der IdentityVerificationService haben Sie folgende Möglichkeiten:

• Den Status des Überprüfungsverfahrens für ein Kundenkonto einschließlich etwaiger Fristen abrufen
• Überprüfungsverfahren starten

Bestätigungsstatus abrufen

Wenn Sie den Status des Überprüfungsverfahrens für Werbetreibende für ein Kundenkonto abrufen möchten, rufen Sie die Methode GetIdentityVerification auf:

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
      

Wenn das Kundenkonto für das obligatorische Programm zur Überprüfung der Identität von Werbetreibenden registriert ist, gibt der Dienst eine nicht leere Antwort mit einer Liste von IdentityVerification-Objekten zurück. Eine leere Antwort bedeutet, dass für das Kundenkonto keine Überprüfung der Identität von Werbetreibenden erforderlich ist.

Ab Version 16 unterstützt die Google Ads API nur das Programm ADVERTISER_IDENTITY_VERIFICATION. Sie ist also der einzige Eintrag in der Liste.

Ein IdentityVerification-Objekt enthält die folgenden Eigenschaften:

• Ein IdentityVerificationRequirement mit den Fristen für den Beginn und Abschluss des Überprüfungsprozesses

• Ein IdentityVerificationProgress mit der Beschreibung des aktuellen Status des Überprüfungsprozesses: Diese kann auch die Aktions-URL enthalten, über die der Nutzer den Bestätigungsvorgang abschließen kann.

Bestätigung starten

Wenn ein Kundenkonto für das obligatorische Überprüfungsverfahren für Werbetreibende – GetIdentityVerification – eine nicht leere Antwort mit einer Frist für den Abschluss des Überprüfungsprozesses zurückgegeben hat, können Sie StartIdentityVerification aufrufen, um eine Überprüfungssitzung zu starten:

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
      

Dies ist nur erfolgreich, wenn keine weitere Überprüfungssitzung läuft. Sobald Sie eine Bestätigungssitzung gestartet haben, geben nachfolgende Aufrufe von GetIdentityVerification die Aktions-URL zurück, mit der der Nutzer den Bestätigungsprozess abschließen kann, sowie die Ablaufzeit der Aktions-URL.

Nach Ablauf der Ablaufzeit können Sie StartIdentityVerification noch einmal aufrufen, um eine neue Bestätigungssitzung zu starten.