사용자에게 안전하고 신뢰할 수 있는 광고 생태계를 제공하고 새 규정에 따라 광고주는 현재 하나 이상의 인증 프로그램이 있습니다.
인증 프로그램을 완료해야 하는 경우 기한이 설정될 수 있습니다. 확인 절차를 거쳐야 합니다. 인증 없이 기한이 지난 경우 완료되면 계정이 일시중지될 수 있습니다.
이때 별도의 인증 절차를 거치지 않아도 사전에 인증을 받을 수 있습니다.
IdentityVerificationService
는 다음을 수행하는 메서드를 제공합니다.
- 고객 계정의 확인 절차 상태를 가져옵니다. 모든 기한을 포함하여
- 인증 절차 시작하기
확인 상태 가져오기
계정의 광고주 신원 확인 절차 상태를
고객 계정의 경우 GetIdentityVerification
메서드를 호출합니다.
자바
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
:
자바
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
를 호출할 수 있습니다.
새 인증 세션을 시작합니다.