REST Resource: guaranteedOrders

সম্পদ: গ্যারান্টিডঅর্ডার

একটি নিশ্চিত আদেশ.

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

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,

  // Union field read_write_accessor can be only one of the following:
  "readWritePartnerId": string,
  "readWriteAdvertiserId": string
  // End of list of possible types for union field read_write_accessor.
}
ক্ষেত্র
name

string

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

legacyGuaranteedOrderId

string

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

exchange

enum ( Exchange )

প্রয়োজন। অপরিবর্তনীয়। বিনিময় যেখানে নিশ্চিত আদেশ উদ্ভূত.

guaranteedOrderId

string

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

displayName

string

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

UTF-8 সর্বাধিক 240 বাইটের আকারের সাথে এনকোড করা আবশ্যক৷

status

object ( GuaranteedOrderStatus )

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

updateTime

string ( Timestamp format)

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

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

publisherName

string

প্রয়োজন। নিশ্চিত আদেশের প্রকাশকের নাম।

UTF-8 সর্বাধিক 240 বাইটের আকারের সাথে এনকোড করা আবশ্যক৷

readAccessInherited

boolean

readWritePartnerId এর সমস্ত বিজ্ঞাপনদাতারা নিশ্চিত অর্ডারে পড়ার অ্যাক্সেস পেয়েছেন কিনা। readWritePartnerId সেট করা থাকলে শুধুমাত্র প্রযোজ্য। সত্য হলে, readAdvertiserIds ওভাররাইড করে।

readAdvertiserIds[]

string ( int64 format)

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

যদি এটি সেট করা থাকে তাহলে readWriteAdvertiserId এ নির্ধারিত বিজ্ঞাপনদাতাকে এই ক্ষেত্রটিতে অন্তর্ভুক্ত করা উচিত নয়। এই ক্ষেত্রের সমস্ত বিজ্ঞাপনদাতাদের অবশ্যই readWritePartnerId বা readWriteAdvertiserId এর একই অংশীদার হতে হবে৷

defaultAdvertiserId

string ( int64 format)

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

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

defaultCampaignId

string ( int64 format)

ডিফল্ট প্রচারাভিযানের আইডি যা নিশ্চিত অর্ডারে বরাদ্দ করা হয়।

ডিফল্ট প্রচারাভিযান অবশ্যই ডিফল্ট বিজ্ঞাপনদাতার অন্তর্গত।

ইউনিয়ন ক্ষেত্র read_write_accessor . প্রয়োজন।

অংশীদার বা বিজ্ঞাপনদাতা নিশ্চিত অর্ডারে পড়ার/লেখার অ্যাক্সেস সহ। read_write_accessor নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

readWritePartnerId

string ( int64 format)

নিশ্চিত অর্ডারে পড়ার/লিখতে অ্যাক্সেস সহ অংশীদার।

readWriteAdvertiserId

string ( int64 format)

গ্যারান্টিযুক্ত অর্ডার পড়ার / লেখার অ্যাক্সেস সহ বিজ্ঞাপনদাতা৷ এটি নিশ্চিত অর্ডারের ডিফল্ট বিজ্ঞাপনদাতাও।

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

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

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

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

সর্বাধিক 100 বাইটের দৈর্ঘ্য সহ UTF-8 এনকোড করা আবশ্যক৷

শুধুমাত্র প্রযোজ্য যখন entityStatus ENTITY_STATUS_PAUSED এ সেট করা থাকে।

configStatus

enum ( GuaranteedOrderConfigStatus )

শুধুমাত্র আউটপুট। নিশ্চিত অর্ডার কনফিগারেশন অবস্থা.

গ্রহণযোগ্য মানগুলি PENDING এবং COMPLETED

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

গ্যারান্টিযুক্তঅর্ডার কনফিগ স্ট্যাটাস

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

এনামস
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED এই সংস্করণে অনুমোদনের অবস্থা নির্দিষ্ট করা নেই বা অজানা।
PENDING একটি গ্যারান্টিযুক্ত অর্ডারের শুরুর অবস্থা। এই রাজ্যে নিশ্চিত অর্ডার পরিবেশন করার আগে কনফিগার করা প্রয়োজন।
COMPLETED ক্রেতা একটি নিশ্চিত অর্ডার কনফিগার করার পরে রাষ্ট্র.

পদ্ধতি

create

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

editGuaranteedOrderReadAccessors

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

get

একটি নিশ্চিত অর্ডার পায়.

list

গ্যারান্টিযুক্ত অর্ডারগুলি তালিকা করে যা বর্তমান ব্যবহারকারীর কাছে অ্যাক্সেসযোগ্য।

patch

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