기본 사용법

클라이언트 라이브러리의 기본 사용법은 다음과 같습니다.

use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\Ads\GoogleAds\Lib\V26\GoogleAdsClientBuilder;

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

// Construct a Google Ads client configured from a properties file and the
// OAuth 2.0 credentials.
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    // Replace 1234567890 with your login customer ID.
    ->withLoginCustomerId(1234567890)
    ->build();

// Create the CampaignServiceClient.
$campaignServiceClient = $googleAdsClient->getCampaignServiceClient();

// Make calls to CampaignServiceClient.

클라이언트 및 서비스 초기화

Google Ads API에 요청하려면 먼저 클라이언트 인스턴스를 초기화한 후 이를 사용하여 서비스 클라이언트를 만듭니다.

GoogleAdsClient 인스턴스 만들기

Google Ads API PHP 라이브러리에서 가장 중요한 클래스는 GoogleAdsClient 클래스입니다. 이를 통해 API 호출에 사용할 수 있는 사전 구성된 서비스 클라이언트 객체를 만들 수 있습니다. GoogleAdsClient 는 다음과 같은 여러 가지 방법으로 구성하고 인스턴스화할 수 있습니다.

  • google_ads_php.ini 파일을 사용합니다.
  • 환경 변수를 설정합니다.
  • GoogleAdsClientBuilder에서 setter 메서드를 호출합니다.

자세한 내용은 구성 가이드를 참고하세요.

명시적 설정으로 GoogleAdsClient 객체를 구성하려면 OAuth2TokenBuilder 객체와 GoogleAdsClientBuilder 객체를 만들고 적절한 setter 메서드를 호출합니다.

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->withClientId('INSERT_CLIENT_ID_HERE')
    ->withClientSecret('INSERT_CLIENT_SECRET_HERE')
    ->withRefreshToken('INSERT_REFRESH_TOKEN_HERE')
    ->build();

// Construct a Google Ads client configured from explicit settings and the
// OAuth 2.0 credentials.
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->withOAuth2Credential($oAuth2Credential)
    // Replace 1234567890 with your login customer ID.
    ->withLoginCustomerId(1234567890)
    ->build();

서비스 만들기

GoogleAdsClient는 모든 서비스 클라이언트 객체에 getter 메서드를 제공합니다. 예를 들어 CampaignServiceClient 인스턴스를 만들려면 앞의 예와 같이 $googleAdsClient->getCampaignServiceClient() 메서드를 호출합니다.

오류 처리

모든 API 호출이 성공하는 것은 아닙니다. API 호출이 어떤 이유로든 실패하면 서버에서 오류가 발생할 수 있습니다. API 오류를 캡처하고 적절하게 처리하는 것이 중요합니다.

API 오류가 발생하면 GoogleAdsException 인스턴스가 발생합니다. 여기에는 문제를 파악하는 데 도움이 되는 세부정보가 포함되어 있습니다.

use Google\Ads\GoogleAds\Lib\V26\GoogleAdsException;
use Google\ApiCore\ApiException;

try {
    // Make your API call here.
} catch (GoogleAdsException $googleAdsException) {
    printf(
        "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
        $googleAdsException->getRequestId(),
        PHP_EOL,
        PHP_EOL
    );
    foreach (
        $googleAdsException->getGoogleAdsFailure()->getErrors() as $error
    ) {
        printf(
            "\t%s: %s%s",
            $error->getErrorCode()->getErrorCode(),
            $error->getMessage(),
            PHP_EOL
        );
    }
} catch (ApiException $apiException) {
    printf(
        "ApiException was thrown with message '%s'.%s",
        $apiException->getMessage(),
        PHP_EOL
    );
}