Method: adPlays.createWithExternalIds

বাহ্যিক আইডি সহ একটি বিজ্ঞাপন খেলা তৈরি করে।

  • সফল হলে নতুন তৈরি বিজ্ঞাপন প্লে ফেরত দেয়।
  • যদি অবৈধ বিজ্ঞাপন ইউনিট বাহ্যিক আইডি, অর্ডার এক্সটার্নাল আইডি, লাইন এক্সটার্নাল আইডি, বা ক্রিয়েটিভ অ্যাসেট এক্সটার্নাল আইডি নির্দিষ্ট করা থাকে তাহলে ত্রুটি কোড INVALID_ARGUMENT প্রদান করে।
  • ত্রুটি কোড INVALID_ARGUMENT প্রদান করে যদি একই বিজ্ঞাপন ইউনিট, অর্ডার, লাইন, এবং একই স্টার্টটাইম সহ ক্রিয়েটিভের জন্য একটি বিজ্ঞাপন প্লে হয়।
  • কোনো বিজ্ঞাপন ইউনিট বাহ্যিক আইডি, অর্ডার এক্সটার্নাল আইডি, লাইন এক্সটার্নাল আইডি, বা ক্রিয়েটিভ অ্যাসেট এক্সটার্নাল আইডি না পাওয়া গেলে ত্রুটি কোড NOT_FOUND প্রদান করে।

HTTP অনুরোধ

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
ক্ষেত্র
lineExternalId

string

প্রয়োজন। এই বিজ্ঞাপনটি যে লাইনের বাহ্যিক আইডির অন্তর্গত। বিন্যাস: 123 ।

orderExternalId

string

প্রয়োজন। এই বিজ্ঞাপনটি যে অর্ডারের বাহ্যিক আইডি। বিন্যাস: 456 ।

adUnitExternalId

string

প্রয়োজন। বিজ্ঞাপন ইউনিটের বাহ্যিক আইডিতে এই বিজ্ঞাপনটি দেখানো হয়েছিল। বিন্যাস: 789 ।

creativeAssetExternalId

string

প্রয়োজন। ক্রিয়েটিভের বাহ্যিক আইডি এই বিজ্ঞাপন প্লে পরিবেশিত. বিন্যাস: 3210 ।

startTime

string ( Timestamp format)

প্রয়োজন। বিজ্ঞাপনটি চালানো শুরু করার সময় (অন্তর্ভুক্ত)। অতীতে এবং শেষ 3 দিনের মধ্যে হওয়া উচিত।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

endTime

string ( Timestamp format)

প্রয়োজন। বিজ্ঞাপন প্লে শেষ হওয়ার সময় (এক্সক্লুসিভ)। অতীতে এবং শুরুর সময়ের পরে হওয়া উচিত।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

recordTime

string ( Timestamp format)

ঐচ্ছিক। এই বিজ্ঞাপন প্লে রেকর্ড করা হয়েছে সময়. অতীতে এবং শেষ সময়ের পরে হওয়া উচিত।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

impressions

number

প্রয়োজন। ইম্প্রেশনের মোট সংখ্যা।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে AdPlay এর একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/doubleclickbidmanager

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।