Offrire agli utenti un ecosistema pubblicitario sicuro e affidabile e rispettare normative emergenti, Google ora richiede agli inserzionisti di completare uno o più programmi di verifica.
Se ti viene richiesto di completare un programma di verifica, è possibile che sia stata impostata una scadenza per la procedura di verifica. Se la scadenza viene trascorsa senza verifica il tuo account potrebbe essere messo in pausa.
Puoi anche sottoporti alla verifica in modo proattivo senza dover farlo.
La IdentityVerificationService
offre metodi per:
- Recuperare lo stato della procedura di verifica per un account cliente, incluse eventuali scadenze
- Avviare una procedura di verifica
Recuperare lo stato della verifica
Per recuperare lo stato della procedura di verifica dell'identità dell'inserzionista per un
account cliente, chiama il metodo 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; }
Se l'account del cliente è registrato nell'identità dell'inserzionista obbligatoria
di verifica, il servizio restituisce una risposta non vuota contenente
di oggetti IdentityVerification
. Un
la risposta vuota indica che l'account del cliente non deve sottoporsi
verifica dell'identità dell'inserzionista.
A partire dalla versione 16, l'API Google Ads supporta solo il ADVERTISER_IDENTITY_VERIFICATION
programma, quindi sarebbe l'unico elemento dell'elenco.
Un oggetto IdentityVerification
contiene le seguenti proprietà:
Una
IdentityVerificationRequirement
che descrive le scadenze per avviare e completare la procedura di verificaUn elemento
IdentityVerificationProgress
che descrive lo stato attuale della la procedura di verifica, che può includere anche l'URL di azione per l'utente per completare la procedura di verifica.
Avvia il processo di verifica
Se un account cliente è registrato nell'identità dell'inserzionista obbligatoria
programma di verifica - GetIdentityVerification
ha restituito un campo non vuoto
con una scadenza per il completamento della procedura di verifica, puoi iniziare
una sessione di verifica chiamando il numero 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); }
Questa operazione avrà esito positivo solo se non è in corso un'altra sessione di verifica.
una volta avviata una sessione di verifica, le chiamate successive a
GetIdentityVerification
restituirà l'URL di azione che l'utente dovrà completare
il processo di verifica e la scadenza dell'URL di azione.
Una volta trascorsa la scadenza, potrai chiamare StartIdentityVerification
di nuovo per avviare una nuova sessione di verifica.