Node.js

Ad Manager API এর সাথে ইন্টারঅ্যাক্ট করার জন্য Google একটি Node.js ক্লায়েন্ট লাইব্রেরি প্রদান করে।

পূর্বশর্ত

Node.js ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে, আপনার Node.js ইনস্টল থাকতে হবে। আরও তথ্যের জন্য, ডাউনলোড Node.js® দেখুন।

ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন

শুরু করতে, আপনার পছন্দের IDE-তে একটি নতুন প্রকল্প তৈরি করুন বা বিদ্যমান প্রকল্পে নির্ভরতা যোগ করুন। Google ক্লায়েন্ট লাইব্রেরি আর্টিফ্যাক্টগুলি npm-এ @google-ads/admanager হিসাবে প্রকাশ করে।

package.json

"dependencies": {
  "@google-ads/admanager": "^0.4.0"
}

কমান্ড লাইন

npm install @google-ads/admanager

শংসাপত্র কনফিগার করুন

প্রমাণীকরণের জন্য, Node.js ক্লায়েন্ট লাইব্রেরি OAuth2 এবং অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র (ADC) ব্যবহার করে। আপনার ADC শংসাপত্র তৈরি এবং কনফিগার করার জন্য, প্রমাণীকরণ দেখুন।

আপনার প্রথম অনুরোধ করুন

প্রতিটি পরিষেবাতে প্রতিটি REST পদ্ধতির পদ্ধতি সহ একটি ServiceClient অবজেক্ট থাকে। প্রতিটি পদ্ধতির উদাহরণের জন্য, GitHub সংগ্রহস্থল googleapis/google-cloud-node দেখুন। নিম্নলিখিত উদাহরণটি একটি Network অবজেক্ট পড়ে:

// Resource name of the Network
const name = 'networks/NETWORK_CODE'

// Imports the Admanager library
const {NetworkServiceClient} = require('@google-ads/admanager').v1;

// Instantiates a client
const admanagerClient = new NetworkServiceClient();

async function callGetNetwork() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await admanagerClient.getNetwork(request);
  console.log(response);
}

callGetNetwork();
network_service.get_network.js

লগ HTTP অনুরোধ এবং প্রতিক্রিয়া

Node.js ক্লায়েন্ট লাইব্রেরি লগিং HTTP অনুরোধ এবং প্রতিক্রিয়া সমর্থন করে। ডিফল্টরূপে, ক্লায়েন্ট লাইব্রেরি লগিং নিষ্ক্রিয় করে।

স্ট্যান্ডার্ড আউটপুটে ডিফল্ট লগিং সক্ষম করতে, পরিবেশ পরিবর্তনশীল GOOGLE_SDK_NODE_LOGGING Google API প্যাকেজ নামের একটি কমা-বিচ্ছিন্ন তালিকাতে সেট করুন। আপনি পরিবর্তনশীল মান all জন্য সেট করে সমস্ত Google API-এর জন্য লগিং সক্ষম করতে পারেন। সমস্ত উপলব্ধ ক্লায়েন্ট লাইব্রেরি প্যাকেজ নামের জন্য, Google Cloud Node.js ক্লায়েন্ট লাইব্রেরিগুলি দেখুন৷

Node.js

// Enable logging for the Google Ad Manager API
process.env.GOOGLE_SDK_NODE_LOGGING = 'admanager';

// Enable logging for the Google Ad Manager and pubsub APIs.
process.env.GOOGLE_SDK_NODE_LOGGING = 'admanager,pubsub';

// Enable logging for all Google APIs
process.env.GOOGLE_SDK_NODE_LOGGING = 'all';

লিনাক্স বা ম্যাকোস

# Enable logging for the Google Ad Manager API.
export GOOGLE_SDK_NODE_LOGGING=admanager

# Enable logging for the Google Ad Manager and pubsub APIs.
export GOOGLE_SDK_NODE_LOGGING=admanager,pubsub

# Enable logging for all Google APIs
export GOOGLE_SDK_NODE_LOGGING=all

উইন্ডোজ

# Enable logging for the Google Ad Manager API.
set GOOGLE_SDK_NODE_LOGGING=admanager

# Enable logging for the Google Ad Manager and pubsub APIs.
set GOOGLE_SDK_NODE_LOGGING=admanager,pubsub

# Enable logging for all Google APIs
set GOOGLE_SDK_NODE_LOGGING=all

বিকল্পভাবে, আপনি লগিং ব্যাকএন্ড বা হুক লগ ইভেন্ট পরিবর্তন করতে পারেন। আরও তথ্যের জন্য, Google লগিং টুলস দেখুন।

ত্রুটিগুলি পরিচালনা করুন

Node.js ক্লায়েন্ট লাইব্রেরিতে, সমস্ত Ad Manager API ত্রুটিগুলি GaxiosError টাইপের একটি ব্যতিক্রম নিক্ষেপ করে।

অ্যাড ম্যানেজার API ত্রুটিগুলির মধ্যে একটি ত্রুটি বার্তা এবং একটি অনন্য requestId মান রয়েছে যা আপনি API সমর্থন দলকে প্রদান করতে পারেন। সমস্যা সমাধানে সহায়তার জন্য, API সমর্থনের সাথে যোগাযোগ করুন দেখুন। নিম্নলিখিত উদাহরণ requestId মান এবং ত্রুটি বার্তা বের করে:

const admanagerClient = new NetworkServiceClient();
try {
  const network = admanagerClient.getNetwork(
    { name: 'networks/NETWORK_CODE' }
  );
  console.log(network);
} catch(e) {
  if (e instanceof GaxiosError) {
    // Load the error
    const apiError = JSON.parse(e.message).error;
    const requestInfoType = 'type.googleapis.com/google.rpc.RequestInfo';
    const requestInfo = apiError.details.find(detail => detail['@type'] === requestInfoType);
    console.error(apiError.status + ' - ' + apiError.message);
    console.error('RequestId: ' + requestInfo.requestId);
  } else {
    throw e;
  }
}