광고주 신원 확인

사용자에게 안전하고 신뢰할 수 있는 광고 생태계를 제공하고 새로운 규정을 준수하기 위해 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.V16.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

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
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

고객 계정이 필수 광고주 신원 확인 프로그램에 등록된 경우 서비스는 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.V16.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

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

Perl

sub start_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $request =
    Google::Ads::GoogleAds::V16::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를 다시 호출하여 새 인증 세션을 시작할 수 있습니다.

이전
일정 변경