ক্লায়েন্ট লাইব্রেরির মৌলিক ব্যবহার নিম্নরূপ:
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 ইনস্ট্যান্স তৈরি করুন
Google Ads API PHP লাইব্রেরির সবচেয়ে গুরুত্বপূর্ণ ক্লাস হল GoogleAdsClient ক্লাস। এটি আপনাকে পূর্ব-কনফিগার করা পরিষেবা ক্লায়েন্ট অবজেক্ট তৈরি করতে দেয় যা API কল করার জন্য ব্যবহার করা যেতে পারে। GoogleAdsClient এটিকে ইনস্ট্যান্ট করার বিভিন্ন উপায় প্রদান করে:
- একটি
google_ads_php.iniফাইল ব্যবহার করুন। - পরিবেশ ভেরিয়েবল ব্যবহার করে।
-
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 প্রতিটি পরিষেবা ক্লায়েন্ট অবজেক্টের জন্য একটি গেটার পদ্ধতি প্রদান করে। উদাহরণস্বরূপ, CampaignServiceClient এর একটি উদাহরণ তৈরি করতে, পূর্ববর্তী উদাহরণে দেখানো GoogleAdsClient->getCampaignServiceClient() পদ্ধতিটি কল করুন।
ত্রুটি পরিচালনা
প্রতিটি API কল সফল হবে না। যদি আপনার API কলগুলি কোনও কারণে ব্যর্থ হয় তবে সার্ভার ত্রুটিগুলি ফেলতে পারে। API ত্রুটিগুলি ক্যাপচার করা এবং সেগুলি যথাযথভাবে পরিচালনা করা গুরুত্বপূর্ণ।
যখন কোনও API ত্রুটি ঘটে তখন একটি GoogleAdsException ইনস্ট্যান্স থ্রো করা হয়। কী ভুল হয়েছে তা বের করতে আপনাকে সাহায্য করার জন্য এতে বিশদ বিবরণ রয়েছে:
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
);
}