REST Resource: guaranteedOrders

Resource: GuaranteedOrder

গ্যারেন্টিযুক্ত অর্ডার।

গ্যারেন্টিযুক্ত অর্ডার হল গ্যারেন্টিযুক্ত ইনভেনটরি সোর্সের পেরেন্ট এন্টিটি। গ্যারেন্টিযুক্ত ইনভেনটরি সোর্স তৈরি করার সময়, ইনভেনটরি সোর্সে অবশ্যই একটি গ্যারেন্টিযুক্ত অর্ডার আইডি অ্যাসাইন করতে হবে।

JSON উপস্থাপনা 
{
  "name": string,
  "legacyGuaranteedOrderId": string,
  "exchange": enum (Exchange),
  "guaranteedOrderId": string,
  "displayName": string,
  "status": {
    object (GuaranteedOrderStatus)
  },
  "updateTime": string,
  "publisherName": string,
  "readAccessInherited": boolean,
  "readAdvertiserIds": [
    string
  ],
  "defaultAdvertiserId": string,
  "defaultCampaignId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "readWritePartnerId": string,
  "readWriteAdvertiserId": string
  // End of mutually exclusive fields.
}
ফিল্ড
name

string

শুধু আউটপুট। গ্যারেন্টিযুক্ত অর্ডারের রিসোর্স নাম।
legacyGuaranteedOrderId

string

শুধু আউটপুট। গ্যারান্টিযুক্ত অর্ডারের লিগ্যাসি আইডি। আসল এক্সচেঞ্জ দ্বারা অ্যাসাইন করা হয়েছে। লিগেসি আইডি একটি এক্সচেঞ্জের মধ্যে অনন্য, তবে সমস্ত গ্যারান্টিযুক্ত অর্ডার জুড়ে অনন্য হওয়ার গ্যারান্টি নেই। এই আইডি SDF ও UI-তে ব্যবহার করা হয়।
exchange

enum (Exchange)

প্রয়োজনীয়। পরিবর্তন করা যাবে না। যে এক্সচেঞ্জ থেকে গ্যারেন্টিযুক্ত অর্ডারটি এসেছে।
guaranteedOrderId

string

শুধু আউটপুট। গ্যারেন্টিযুক্ত অর্ডারের অনন্য শনাক্তকারী। গ্যারান্টিযুক্ত অর্ডার আইডির ফর্ম্যাট হল {exchange}-{legacyGuaranteedOrderId}।
displayName

string

প্রয়োজনীয়। গ্যারান্টিযুক্ত অর্ডারের ডিসপ্লে নাম।

সর্বাধিক ২৪০ বাইট সাইজের UTF-8 এনকোডেড হতে হবে।
status

object (GuaranteedOrderStatus)

গ্যারেন্টিযুক্ত অর্ডারের স্ট্যাটাস সেটিংস।
updateTime

string (Timestamp format)

শুধু আউটপুট। গ্যারেন্টিযুক্ত অর্ডার শেষবার আপডেট করার টাইমস্ট্যাম্প। সিস্টেমের মাধ্যমে অ্যাসাইন করা হয়েছে।

RFC 3339 ব্যবহার করে, যেখানে জেনারেট করা আউটপুট সবসময় Z-নরমালাইজড হবে এবং ০, ৩, ৬ বা ৯টি ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ছাড়া অন্যান্য অফসেটও গ্রহণ করা হয়। যেমন: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"।
publisherName

string

প্রয়োজনীয়। গ্যারেন্টিযুক্ত অর্ডারের প্রকাশকের নাম।

সর্বাধিক ২৪০ বাইট সাইজের UTF-8 এনকোডেড হতে হবে।
readAccessInherited

boolean

readWritePartnerId-এর সব বিজ্ঞাপনদাতার কাছে গ্যারেন্টিযুক্ত অর্ডারের রিড অ্যাক্সেস আছে কিনা। readWritePartnerId সেট করা থাকলে তবেই প্রযোজ্য। True হলে, readAdvertiserIds ওভাররাইড করে।
readAdvertiserIds[]

string (int64 format)

গ্যারেন্টিযুক্ত অর্ডারে রিড অ্যাক্সেস সহ বিজ্ঞাপনদাতার আইডি।

এই ফিল্ডে readWriteAdvertiserId-এ অ্যাসাইন করা বিজ্ঞাপনদাতা অন্তর্ভুক্ত করা যাবে না, যদি এটি সেট করা থাকে। এই ফিল্ডের সব বিজ্ঞাপনদাতাকে অবশ্যই readWritePartnerId বা readWriteAdvertiserId-এর মতো একই পার্টনারের হতে হবে।
defaultAdvertiserId

string (int64 format)

শুধু আউটপুট। গ্যারেন্টিযুক্ত অর্ডারের ডিফল্ট বিজ্ঞাপনদাতার আইডি।

ডিফল্ট বিজ্ঞাপনদাতা হল readWriteAdvertiserId অথবা সেটি সেট করা না থাকলে readAdvertiserIds-এ তালিকাভুক্ত প্রথম বিজ্ঞাপনদাতা। অন্যথায়, কোনও ডিফল্ট বিজ্ঞাপনদাতা নেই।
defaultCampaignId

string (int64 format)

গ্যারেন্টিযুক্ত অর্ডারে অ্যাসাইন করা ডিফল্ট ক্যাম্পেনের আইডি।

ডিফল্ট ক্যাম্পেন অবশ্যই ডিফল্ট বিজ্ঞাপনদাতার হতে হবে।

প্রয়োজনীয়।

গ্যারেন্টিযুক্ত অর্ডারে রিড/রাইট অ্যাক্সেস সহ পার্টনার বা বিজ্ঞাপনদাতা। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
readWritePartnerId

string (int64 format)

গ্যারান্টিযুক্ত অর্ডারে রিড/রাইট অ্যাক্সেস সহ পার্টনার।
readWriteAdvertiserId

string (int64 format)

গ্যারান্টিযুক্ত অর্ডারে বিজ্ঞাপনদাতার রিড/রাইট অ্যাক্সেস আছে। এছাড়াও, এটি হল গ্যারেন্টিযুক্ত অর্ডারের ডিফল্ট বিজ্ঞাপনদাতা।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

GuaranteedOrderStatus

গ্যারেন্টিযুক্ত অর্ডারের স্ট্যাটাস সেটিংস।

JSON উপস্থাপনা 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "configStatus": enum (GuaranteedOrderConfigStatus)
}
ফিল্ড
entityStatus

enum (EntityStatus)

গ্যারেন্টিযুক্ত অর্ডারটি পরিবেশনযোগ্য কিনা।

গ্রহণযোগ্য ভ্যালু হল ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED এবং ENTITY_STATUS_PAUSED। ডিফল্ট ভ্যালু হল ENTITY_STATUS_ACTIVE।
entityPauseReason

string

এই গ্যারেন্টিযুক্ত অর্ডার পজ করার জন্য ব্যবহারকারীর দেওয়া কারণ।

সর্বাধিক ১০০ বাইট দৈর্ঘ্যের UTF-8 এনকোডেড হতে হবে।

entityStatus-এর মান ENTITY_STATUS_PAUSED-এ সেট করা থাকলে তবেই প্রযোজ্য।
configStatus

enum (GuaranteedOrderConfigStatus)

শুধু আউটপুট। গ্যারেন্টিযুক্ত অর্ডারের কনফিগারেশন স্ট্যাটাস।

গ্রহণযোগ্য ভ্যালু হল PENDING এবং COMPLETED।

গ্যারেন্টিযুক্ত অর্ডার দেখানোর আগে সেটি কনফিগার করতে হবে (প্রয়োজনীয় ফিল্ড পূরণ করুন, ক্রিয়েটিভ বেছে নিন এবং ডিফল্ট ক্যাম্পেন বেছে নিন)। বর্তমানে কনফিগারেশন অ্যাকশন শুধুমাত্র UI-এর মাধ্যমে করা যাবে।

GuaranteedOrderConfigStatus

গ্যারেন্টিযুক্ত অর্ডারের জন্য সম্ভাব্য কনফিগারেশন স্ট্যাটাস।

Enums
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED এই ভার্সনে অনুমোদনের স্ট্যাটাস উল্লেখ করা নেই বা অজানা।
PENDING গ্যারেন্টিযুক্ত অর্ডারের প্রাথমিক অবস্থা। এই অবস্থায় গ্যারেন্টিযুক্ত অর্ডার দেখানোর আগে তা কনফিগার করতে হবে।
COMPLETED ক্রেতা গ্যারান্টিযুক্ত অর্ডার কনফিগার করার পরে স্ট্যাটাস।

পদ্ধতি

create

 নতুন গ্যারেন্টিযুক্ত অর্ডার তৈরি করে।

editGuaranteedOrderReadAccessors

 গ্যারান্টিযুক্ত অর্ডারের বিজ্ঞাপনদাতাদের এডিট করার অনুমতি দেয়।

get

 গ্যারান্টিযুক্ত অর্ডার পায়।

list

 বর্তমান ব্যবহারকারীর অ্যাক্সেস আছে এমন গ্যারেন্টিযুক্ত অর্ডারের তালিকা দেখায়।

patch

 আগে থেকে থাকা গ্যারেন্টিযুক্ত অর্ডার আপডেট করে।