SOAP XML অনুরোধ ও উত্তর হেডার

এই পৃষ্ঠায় প্রয়োজনীয় SOAP XML অনুরোধ হেডার এবং উত্তরে ফেরত আসা হেডারের ব্যাপারে তথ্য দেওয়া হয়েছে।

প্রয়োজনীয় অনুরোধের হেডার

সব API SOAP কলে অবশ্যই একটি <RequestHeader> এলিমেন্ট হেডারে থাকতে হবে; এই এলিমেন্ট সব পরিষেবা WSDL-এ সংজ্ঞায়িত করা আছে। ক্লায়েন্ট লাইব্রেরি আপনার দেওয়া ভ্যালু ব্যবহার করে এই হেডার যোগ করার পদ্ধতি প্রদান করে। <RequestHeader>-এর সব এলিমেন্টের বিবরণ এখানে দেওয়া হল:

এলিমেন্ট বিবরণ
<networkCode>

যে নেটওয়ার্ককে অ্যাড্রেস করা হচ্ছে সেটির নেটওয়ার্ক কোড। NetworkService.getAllNetworks() এবং NetworkService.makeTestNetwork() ছাড়া সব অনুরোধ করার সময় নেটওয়ার্ক কোড প্রয়োজন।

আপনার অ্যাকাউন্ট লগ-ইনে উপলভ্য নেটওয়ার্ক কোডই শুধু ব্যবহার করছেন কিনা তা নিশ্চিত করুন। আপনার অ্যাকাউন্টের জন্য Google Ad Manager ওয়েবসাইটে, 'অ্যাডমিন > নেটওয়ার্ক সেটিংস' পৃষ্ঠায় "নেটওয়ার্ক কোড" বিকল্পের পাশে কোডটি দেখতে পাবেন।
<applicationName> আপনার অ্যাপ্লিকেশন শনাক্ত করার জন্য একটি ইচ্ছামতো স্ট্রিং নাম। এটি Google-এর লগ ফাইলে দেখানো হবে। যেমন: "My Inventory Application" বা "App_1"।

মনে রাখবেন: Ad Manager API-তে আপনার অ্যাপ্লিকেশন থেকে পাঠানো প্রতিটি অনুরোধে অবশ্যই OAuth2 অ্যাক্সেস টোকেন থাকতে হবে। HTTP হেডারে টোকেনটি এইভাবে পাস করুন: Authorization: Bearer YOUR_ACCESS_TOKEN।

উদাহরণস্বরূপ অনুরোধ

নিম্নলিখিত কোডটি হল getAdUnitsByStatement()-এ SOAP অনুরোধ কলের একটি উদাহরণ যা রুট AdUnit খুঁজছে।

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope
        xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header>
    <ns1:RequestHeader
         soapenv:actor="http://schemas.xmlsoap.org/soap/actor/next"
         soapenv:mustUnderstand="0"
         xmlns:ns1="https://www.google.com/apis/ads/publisher/v202608">
      <ns1:networkCode>123456</ns1:networkCode>
      <ns1:applicationName>DfpApi-Java-2.1.0-dfp_test</ns1:applicationName>
    </ns1:RequestHeader>
  </soapenv:Header>
  <soapenv:Body>
    <getAdUnitsByStatement xmlns="https://www.google.com/apis/ads/publisher/v202608">
      <filterStatement>
        <query>WHERE parentId IS NULL LIMIT 500</query>
      </filterStatement>
    </getAdUnitsByStatement>
  </soapenv:Body>
</soapenv:Envelope>

মনে রাখবেন: আপনার SOAP অনুরোধের কারণে Unmarshalling error হলে, সমস্যার সমাধান সংক্রান্ত পরামর্শের জন্য সাধারণ সমস্যা দেখুন।

রেসপন্স হেডার

API থেকে পাওয়া সব উত্তরে নিম্নলিখিত হেডার এলিমেন্ট থাকে। পেশাদার পদ্ধতি হিসেবে, আমরা আপনাকে এইসব ভ্যালু লগ করতে সাজেস্ট করি।

এলিমেন্ট বিবরণ
<requestId> এই অনুরোধকে অনন্যভাবে শনাক্ত করে। সহায়তা সংক্রান্ত কোনও সমস্যা হলে, আমাদের এই আইডি পাঠালে আমরা আপনার অনুরোধ আরও সহজে খুঁজে পাব।
<responseTime> ওয়েব সার্ভিস অনুরোধ পাওয়ার পর থেকে উত্তর পাঠানোর মধ্যে অতিক্রান্ত সময়।

উদাহরণস্বরূপ উত্তর

নিম্নলিখিত কোডটি পূর্ববর্তী অনুরোধের জন্য SOAP উত্তরের একটি উদাহরণ দেখায়।

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <ResponseHeader xmlns="https://www.google.com/apis/ads/publisher/v202608">
      <requestId>xxxxxxxxxxxxxxxxxxxx</requestId>
      <responseTime>1063</responseTime>
    </ResponseHeader>
  </soap:Header>
  <soap:Body>
    <getAdUnitsByStatementResponse xmlns="https://www.google.com/apis/ads/publisher/v202608">
      <rval>
        <totalResultSetSize>1</totalResultSetSize>
        <startIndex>0</startIndex>
        <results>
          <id>2372</id>
          <name>RootAdUnit</name>
          <description></description>
          <targetWindow>TOP</targetWindow>
          <status>ACTIVE</status>
          <adUnitCode>1002372</adUnitCode>
          <inheritedAdSenseSettings>
            <value>
              <adSenseEnabled>true</adSenseEnabled>
              <borderColor>FFFFFF</borderColor>
              <titleColor>0000FF</titleColor>
              <backgroundColor>FFFFFF</backgroundColor>
              <textColor>000000</textColor>
              <urlColor>008000</urlColor>
              <adType>TEXT_AND_IMAGE</adType>
              <borderStyle>DEFAULT</borderStyle>
              <fontFamily>DEFAULT</fontFamily>
              <fontSize>DEFAULT</fontSize>
            </value>
          </inheritedAdSenseSettings>
        </results>
      </rval>
    </getAdUnitsByStatementResponse>
  </soap:Body>
</soap:Envelope>