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.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; }
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üfungsprozessesEin
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.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); }
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.