광고주 신원 확인

사용자에게 안전하고 신뢰할 수 있는 광고 생태계를 제공하고 새 규정에 따라 광고주는 현재 하나 이상의 인증 프로그램이 있습니다.

인증 프로그램을 완료해야 하는 경우 기한이 설정될 수 있습니다. 확인 절차를 거쳐야 합니다. 인증 없이 기한이 지난 경우 완료되면 계정이 일시중지될 수 있습니다.

이때 별도의 인증 절차를 거치지 않아도 사전에 인증을 받을 수 있습니다. 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;
    }


}
VerifyAdvertiserIdentity.cs

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
verify_advertiser_identity.rb

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;
}
verify_advertiser_identity.pl

고객 계정이 필수 광고주 ID에 등록된 경우 서비스는 IdentityVerification 객체 목록 빈 응답은 고객 계정이 광고주 신원 확인

v16부터 Google Ads API는 ADVERTISER_IDENTITY_VERIFICATION 프로그램이므로 이 목록에 있는 유일한 항목이 됩니다.

IdentityVerification 객체에는 다음 속성이 포함됩니다.

확인 절차 시작

고객 계정이 필수 광고주 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;
    }
}
VerifyAdvertiserIdentity.cs

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
verify_advertiser_identity.rb

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);
}
verify_advertiser_identity.pl

진행 중인 다른 인증 세션이 없는 경우에만 성공적으로 처리됩니다. 인증 세션을 시작하면 GetIdentityVerification는 사용자가 완료할 작업 URL을 반환합니다. 확인 절차 및 작업 URL 만료 시간

만료 시간이 지난 후에 StartIdentityVerification를 호출할 수 있습니다. 새 인증 세션을 시작합니다.

이전
일정 변경