Überprüfung der Identität von Werbetreibenden

Wir möchten Nutzern eine sichere, vertrauenswürdige Werbeumgebung bieten und die Einhaltung neuer Vorschriften ermöglichen. Aus diesem Grund müssen Werbetreibende jetzt ein oder mehrere Überprüfungsverfahren durchlaufen.

Wenn eine Überprüfung erforderlich ist, kann dafür eine Frist festgelegt werden. Wenn die Frist ohne die Bestätigung verstrichen ist, wird Ihr Konto möglicherweise pausiert.

Sie können sich auch proaktiv bestätigen lassen, ohne dazu verpflichtet zu sein. Mit IdentityVerificationService können Sie Folgendes tun:

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

Bestätigungsstatus abrufen

Wenn Sie den Status der Überprüfung der Identität von Werbetreibenden 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.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;
    }


}
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 die obligatorische Überprüfung der Werbetreibendenidentität 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 Bestätigung der Identität als Werbetreibender erforderlich ist.

Die Google Ads API unterstützt nur das Programm ADVERTISER_IDENTITY_VERIFICATION. Dies ist 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, das den aktuellen Status des Überprüfungsprozesses angibt. Dies kann auch die Aktions-URL enthalten, die der Nutzer benötigt, um die Überprüfung abzuschließen.

Bestätigung starten

Wenn ein Kundenkonto für das obligatorische Programm zur Überprüfung der Identität von Werbetreibenden registriert ist (GetIdentityVerification) wurde eine nicht leere Antwort mit einer Frist für den Abschluss der Überprüfung zurückgegeben, können Sie eine Überprüfungssitzung starten, indem Sie StartIdentityVerification aufrufen:

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;
    }
}
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::V18::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 Verifizierungssitzung gestartet haben, geben nachfolgende Aufrufe von GetIdentityVerification die Aktions-URL zurück, damit der Nutzer die Überprüfung abschließen kann, und die Ablaufzeit der Aktions-URL.

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

Zurück
Ereignis ändern