사용자에게 안전하고 신뢰할 수 있는 광고 생태계를 제공하고 새로운 규정을 준수하기 위해 Google은 이제 광고주에게 하나 이상의 인증 프로그램을 완료하도록 요구합니다.
인증 프로그램을 완료해야 하는 경우 인증 프로세스 기한을 설정할 수 있습니다. 기한이 지나기 전에 인증이 완료되지 않으면 계정이 일시중지될 수 있습니다.
인증하지 않아도 사전에 인증을 받을 수도 있습니다. 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; } }
2,399필리핀
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
프로그램만 지원하므로 이 목록에 있는 유일한 항목이 됩니다.
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; } }
2,399필리핀
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
를 다시 호출하여 새 인증 세션을 시작할 수 있습니다.