في ما يلي الاستخدام الأساسي لمكتبة البرامج:
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\Ads\GoogleAds\Lib\V25\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
الفئة الأكثر أهمية في مكتبة PHP الخاصة بواجهة Google Ads API هي فئة GoogleAdsClient. تتيح لك إنشاء عناصر عميل خدمة مضبوطة مسبقًا يمكن استخدامها لإجراء طلبات من واجهة برمجة التطبيقات. توفّر GoogleAdsClient عدة طرق لإعدادها وإنشائها:
- استخدِم ملف
google_ads_php.ini. - اضبط متغيّرات البيئة.
- استدعاء طرق الضبط في
GoogleAdsClientBuilder
لمزيد من المعلومات، يُرجى الرجوع إلى دليل الإعداد.
لضبط عنصر GoogleAdsClient باستخدام إعدادات صريحة، أنشئ عنصر OAuth2TokenBuilder وعنصر GoogleAdsClientBuilder واستخدِم طرق تحديد القيمة المناسبة:
// 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()، كما هو موضّح في المثال السابق.
معالجة الأخطاء
لا تنجح كل طلبات البيانات من واجهة برمجة التطبيقات. يمكن أن يعرض الخادم أخطاءً إذا تعذّرت معالجة طلبات البيانات من واجهة برمجة التطبيقات لسبب ما. من المهم تسجيل أخطاء واجهة برمجة التطبيقات والتعامل معها بشكل مناسب.
يتم عرض مثيل GoogleAdsException عند حدوث خطأ في واجهة برمجة التطبيقات. يتضمّن هذا الرمز تفاصيل تساعدك في معرفة المشكلة التي حدثت:
use Google\Ads\GoogleAds\Lib\V25\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
);
}