প্রাথমিক ব্যবহার

ক্লায়েন্ট লাইব্রেরির প্রাথমিক ব্যবহার নিচে দেওয়া হল:

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-এ সেটার মেথড কল করুন।

আরও জানতে কনফিগারেশন গাইড দেখুন।

স্পষ্ট সেটিংস সহ 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 প্রতিটি পরিষেবা ক্লায়েন্ট অবজেক্টের জন্য একটি গেটার পদ্ধতি প্রদান করে। যেমন, 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
    );
}