安全で信頼できる広告エコシステムをユーザーに提供し、 新たな規制に対応するため、広告主様には 適格性確認プログラム。
適格性確認プログラムを完了する必要がある場合は、期限が設定されている可能性があります をご覧ください。確認なしで期限が過ぎた場合 アカウントが一時停止される可能性があります。
なお、適格性確認を求められることなく、自主的に実施することもできます。
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;
}
お客様のアカウントが必須の広告主 ID に登録されている場合
検証プログラムを実行する場合、サービスは
IdentityVerification オブジェクトのリスト。「
空のレスポンスは、顧客アカウントで
広告主様の身元確認
v16 より、Google Ads API は ADVERTISER_IDENTITY_VERIFICATION のみをサポートしています。
リスト内の唯一のアイテムとなります。
IdentityVerification オブジェクトには、次のプロパティが含まれます。
期限を記述する
IdentityVerificationRequirement適格性確認プロセスを開始してインスタンスの現在のステータスを表す
IdentityVerificationProgress（ユーザーのアクション URL も含まれる場合がある） 確認プロセスを完了してください。
確認処理を開始
お客様のアカウントが必須の広告主 ID に登録されている場合
検証プログラム - 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 を呼び出すことができます。
新しい確認セッションを開始します