প্রতিক্রিয়া মেটাডেটা

পিএইচপি ক্লায়েন্ট লাইব্রেরি ডিফল্টরূপে রিকোয়েস্ট আইডি সহ রেসপন্স মেটাডেটা লগ করে । বিকল্পভাবে, ক্লায়েন্ট সার্ভিস মেথড কল করার সময় ঐচ্ছিক প্যারামিটার withResponseMetadata ` true সেট করে আপনি প্রোগ্রাম্যাটিকভাবে রেসপন্স মেটাডেটা পেতে পারেন।

ক্লায়েন্ট সার্ভিস মেথড কল করার পর, আপনি যে মেথডটি কল করছেন তার উপর নির্ভর করে প্রাসঙ্গিক অবজেক্ট (যেমন একটি সার্ভিস ক্লায়েন্ট বা একটি স্ট্রিম) থেকে একটি GoogleAdsResponseMetadata ইনস্ট্যান্স পেতে পারেন। এই অবজেক্টটি getMetadata() এবং getRequestId() প্রদান করে, যা যথাক্রমে সম্পূর্ণ রেসপন্স মেটাডেটা অ্যারে এবং এপিআই কলের রিকোয়েস্ট আইডি রিটার্ন করে। getMetadata() মেথডটি নিম্নলিখিত আউটপুটের মতো কাঠামোযুক্ত একটি অ্যারে রিটার্ন করে:

object(Google\Ads\GoogleAds\Lib\V25\GoogleAdsResponseMetadata)#51 (1) {
  ["metadata":"Google\Ads\GoogleAds\Lib\V25\GoogleAdsResponseMetadata":private]=>
  array(17) {
    ["content-disposition"]=>
    array(1) {
      [0]=>
      string(10) "attachment"
    }
    ["request-id"]=>
    array(1) {
      [0]=>
      string(22) "REQUEST_ID"
    }
    ...
  }
}

getRequestId() মেথডটি অ্যারের কীগুলো ম্যানুয়ালি পার্স না করেই মেটাডেটা অ্যারে থেকে রিকোয়েস্ট আইডি বের করার প্রক্রিয়াকে সহজ করে তোলে।

নিম্নলিখিত বিভাগগুলিতে প্রতিটি মেথড টাইপের জন্য GoogleAdsResponseMetadata কীভাবে পুনরুদ্ধার করতে হয় তা ব্যাখ্যা করা হয়েছে।

সার্চস্ট্রিম

একটি স্ট্রিমিং কলের জন্য GoogleAdsResponseMetadata অবজেক্ট পেতে, স্ট্রিমটির উপর পুনরাবৃত্তি করার পর স্ট্রিম অবজেক্টের উপর getResponseMetadata() কল করুন:

$stream = $googleAdsServiceClient->searchStream(
    SearchGoogleAdsStreamRequest::build($customerId, $query),
    ['withResponseMetadata' => true]
);

foreach ($stream->iterateAllElements() as $googleAdsRow) {
    // Process each row...
}

// Outputs the request ID.
echo $stream->getResponseMetadata()?->getRequestId() . PHP_EOL;

$stream->getResponseMetadata() একটি GoogleAdsResponseMetadata অবজেক্ট রিটার্ন করে।

অনুসন্ধান এবং পরিবর্তন পদ্ধতি

ইউনারি কলের জন্য একটি GoogleAdsResponseMetadata অবজেক্ট পেতে, সার্ভিস ক্লায়েন্ট অবজেক্টে getResponseMetadata() কল করুন:

// Retrieves objects.
$response = $googleAdsServiceClient->search(
    SearchGoogleAdsRequest::build($customerId, $query),
    ['withResponseMetadata' => true]
);

// Outputs the request ID.
echo $googleAdsServiceClient->getResponseMetadata()?->getRequestId() . PHP_EOL;

// Mutates campaigns.
$response = $campaignServiceClient->mutateCampaigns(
    MutateCampaignsRequest::build($customerId, $campaignOperations),
    ['withResponseMetadata' => true]
);

// Outputs the request ID.
echo $campaignServiceClient->getResponseMetadata()?->getRequestId() . PHP_EOL;

$campaignServiceClient->getResponseMetadata() এবং $googleAdsServiceClient->getResponseMetadata() উভয়ই একটি GoogleAdsResponseMetadata অবজেক্ট রিটার্ন করে।