安全で信頼できる広告エコシステムをユーザーに提供し、新しい規制を遵守するため、Google は広告主様に 1 つ以上の適格性確認プログラムを完了するよう要請しています。
適格性確認プログラムを完了する必要がある場合は、適格性確認プロセスに期限が設定されていることがあります。適格性確認が完了せずに期限を過ぎた場合、アカウントが一時停止される可能性があります。
また、必須ではありませんが、あらかじめ確認を受けることもできます。IdentityVerificationService
には、以下の方法が用意されています。
- 顧客アカウントの確認プロセスのステータス(期限を含む)を取得する
- 適格性確認プロセスを開始する
オーナー確認のステータスを取得する
顧客アカウントの広告主様の身元確認プロセスのステータスを取得するには、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; }
お客様のアカウントが必須の広告主様の身元確認プログラムに登録されている場合、サービスは IdentityVerification
オブジェクトのリストを含む空でないレスポンスを返します。空のレスポンスは、顧客アカウントで広告主様の身元確認を行う必要がないことを示します。
v16 の時点では、Google Ads API は ADVERTISER_IDENTITY_VERIFICATION
プログラムのみをサポートしているため、リスト内のアイテムは ADVERTISER_IDENTITY_VERIFICATION
プログラムのみです。
IdentityVerification
オブジェクトには次のプロパティが含まれています。
検証プロセスの開始と完了の期限を記述する
IdentityVerificationRequirement
。確認プロセスの現在のステータスを記述する
IdentityVerificationProgress
。ユーザーが確認プロセスを完了するためのアクション URL を含めることもできます。
確認処理を開始
必須の広告主様の身元確認プログラムにお客様のアカウントが登録されている場合(GetIdentityVerification
から確認プロセスの完了期限を含む空ではないレスポンスが返された場合)、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); }
別の確認セッションが進行中でない場合にのみ成功します。確認セッションを開始すると、その後 GetIdentityVerification
を呼び出すと、ユーザーが確認プロセスを完了するためのアクション URL と、アクション URL の有効期限が返されます。
有効期限が経過したら、もう一度 StartIdentityVerification
を呼び出して、新しい検証セッションを開始できます。