การใช้งานพื้นฐาน

การใช้งานไลบรารีของไคลเอ็นต์ขั้นพื้นฐานมีดังนี้

use Google\Ads\GoogleAds\Lib\V22\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V22\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V22\GoogleAdsException;
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\ApiCore\ApiException;

// 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
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->build();

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

// Make calls to CampaignServiceClient.

สร้างอินสแตนซ์ GoogleAdsClient

คลาสที่สำคัญที่สุดในไลบรารี PHP ของ Google Ads API คือคลาส GoogleAdsClient ซึ่งช่วยให้คุณสร้างออบเจ็กต์ไคลเอ็นต์บริการที่กำหนดค่าล่วงหน้า ซึ่งใช้ในการเรียก API ได้ GoogleAdsClient มี หลายวิธีในการสร้างอินสแตนซ์ ดังนี้

• ใช้ไฟล์ google_ads_php.ini
• การใช้ตัวแปรสภาพแวดล้อม
• การใช้ Setter ใน GoogleAdsClientBuilder

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการกำหนดค่า

หากต้องการกำหนดค่าออบเจ็กต์ GoogleAdsClient ให้สร้างออบเจ็กต์ OAuth2TokenBuilderและออบเจ็กต์ 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
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->build();

สร้างบริการ

GoogleAdsClient มีเมธอด Getter สำหรับออบเจ็กต์ไคลเอ็นต์บริการทุกรายการ เช่น หากต้องการสร้างอินสแตนซ์ของ CampaignServiceClient ให้เรียกใช้เมธอด GoogleAdsClient->getCampaignServiceClient() ดังที่แสดงในตัวอย่างก่อนหน้า

การจัดการข้อผิดพลาด

การเรียก API ไม่ได้สำเร็จทุกครั้ง เซิร์ฟเวอร์อาจแสดงข้อผิดพลาดหากการเรียก API ล้มเหลวด้วยเหตุผลบางประการ คุณควรบันทึกข้อผิดพลาดของ API และจัดการข้อผิดพลาดเหล่านั้น อย่างเหมาะสม

ระบบจะส่ง GoogleAdsException เมื่อเกิดข้อผิดพลาดของ API โดยมี รายละเอียดที่จะช่วยให้คุณทราบว่าเกิดข้อผิดพลาดใดขึ้น

use Google\Ads\GoogleAds\Lib\V22\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
    );
}