Method: exchanges.orders.products.patch

প্রোডাক্ট আপডেট করে।

HTTP অনুরোধ

PATCH https://dv360seller.googleapis.com/v1beta1/{product.name=exchanges/*/orders/*/products/*}

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

পাথ প্যারামিটার

প্যারামিটারগুলি
product.name

string

প্রোডাক্টের জন্য সম্পর্কিত রিসোর্সের নাম। সার্ভার দ্বারা জেনারেট করা হয়েছে। যেমন: "exchanges/1234/orders/5678/products/abc"। শুধু আউটপুট।

অনুরোধের বডি

অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "product": {
    "name": string,
    "displayName": string,
    "externalDealId": string,
    "transactionType": enum (TransactionType),
    "pricingType": enum (PricingType),
    "updateTime": string,
    "startTime": string,
    "endTime": string,
    "rateDetails": {
      "rateType": enum (RateType),
      "rate": {
        object (Money)
      },
      "unitsPurchasedCount": string
    },
    "creativeConfig": [
      {
        "creativeType": enum (CreativeType),
        "dimensionCreativeConfig": {
          object (DimensionCreativeConfig)
        },
        "durationCreativeConfig": {
          object (DurationCreativeConfig)
        }
      }
    ],
    "makegood": boolean,
    "makegoodDetails": {
      "originalExternalDealId": string,
      "reason": string
    },
    "creativeSource": enum (CreativeSource),
    "mediumType": enum (MediumType),
    "audienceTargetingConfig": {
      "audienceType": enum (AudienceType)
    },
    "targetingCriteria": {
      "selectedTargetingOptions": [
        {
          object (SelectedTargetingOption)
        }
      ]
    },
    "forecastResult": {
      "forecasts": [
        {
          object (Forecast)
        }
      ]
    },
    "errorDetails": {
      "message": string,
      "instantDealErrorStatus": enum (InstantDealErrorStatus)
    },
    "frequencyCap": {
      "timeUnit": enum (TimeUnit),
      "maxImpressions": string
    },
    "program": string,
    "buyerCustomParameters": {
      string: string,
      ...
    },
    "etag": string
  },
  "updateMask": string
}
ফিল্ড
product.displayName

string

প্রোডাক্টের ডিসপ্লে নাম।

সর্বাধিক ২৪০ বাইট সাইজের UTF-8 এনকোডেড হতে হবে। প্রয়োজনীয়।
product.externalDealId

string

এক্সটার্নাল আইডি। এটি এক্সচেঞ্জ সিস্টেমে ডিল আইডি। সর্বাধিক ১০০টি অক্ষর। বর্ণসাংখ্যিক, আন্ডারস্কোর, ড্যাশ ও ডট ব্যবহার করা যাবে। সব প্রোডাক্টের ক্ষেত্রে অনন্য হতে হবে। প্রয়োজনীয়।
product.transactionType

enum (TransactionType)

প্রোডাক্ট ট্রানজ্যাকশনের ধরন। প্রয়োজনীয়।
product.pricingType

enum (PricingType)

প্রোডাক্টের জন্য দামের ধরন। প্রয়োজনীয়।
product.updateTime
(deprecated)

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"।
product.startTime

string (Timestamp format)

এই প্রোডাক্টটি কখন অ্যাক্টিভ হবে। endTime-এর আগে হতে হবে। শুরুর সময় ভবিষ্যতে ১ বছরের বেশি হতে পারবে না। প্রয়োজনীয়।

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

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"।
product.rateDetails

object (RateDetails)

রেটের বিবরণ। প্রয়োজনীয়।
product.creativeConfig[]

object (CreativeConfig)

কোনও প্রোডাক্টের জন্য ক্রিয়েটিভ সংক্রান্ত প্রয়োজনীয়তা। রিজার্ভ করা ট্রানজ্যাকশন ধরনের প্রোডাক্টের জন্য প্রয়োজন।
product.makegood
(deprecated)

boolean

কোনও প্রোডাক্ট মেকগুড প্রোডাক্ট কিনা তা উল্লেখ করে।
product.makegoodDetails
(deprecated)

object (MakegoodDetails)

প্রোডাক্টের জন্য মেকগুড সংক্রান্ত বিবরণ। প্রোডাক্টটি মেকগুড হলে প্রয়োজন।
product.creativeSource

enum (CreativeSource)

প্রোডাক্টের জন্য ক্রিয়েটিভ সোর্স। ঐচ্ছিক, ডিফল্ট হিসেবে CREATIVE_SOURCE_ADVERTISER-এ সেট করা থাকে। প্রোডাক্ট তৈরি করার পরে পরিবর্তন করা যাবে না।
product.mediumType

enum (MediumType)

প্রোডাক্টের জন্য মিডিয়ামের ধরন। ব্যাকওয়ার্ড কম্প্যাটিবিলিটির জন্য উল্লেখ করা না থাকলে, ডিফল্ট হিসেবে DIGITAL সেট করা হয়। প্রোডাক্ট তৈরি করার পরে পরিবর্তন করা যাবে না।
product.audienceTargetingConfig

object (AudienceTargetingConfig)

ঐচ্ছিক। এক্সচেঞ্জে ডিল লেভেলে দর্শক টার্গেটিং কনফিগারেশন প্রয়োগ করা হয়েছে।
product.targetingCriteria

object (TargetingCriteria)

শুধু আউটপুট। প্রোডাক্ট টার্গেটিং সংক্রান্ত মাপকাঠির রেফারেন্স। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিওতে প্রযোজ্য।
product.forecastResult

object (ForecastResult)

প্রোডাক্টের পূর্বাভাস সংক্রান্ত ফলাফল। টার্গেটিং সংক্রান্ত মাপকাঠি ফাঁকা না থাকলে এবং পূর্বাভাস না দেওয়া হলে প্রয়োজন। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিওতে প্রযোজ্য।
product.errorDetails

object (ErrorDetails)

নির্দিষ্ট প্রোডাক্ট ফিল্ড আপডেট করা না গেলে সমস্যার বিবরণ উল্লেখ করতে হবে। টার্গেটিং সংক্রান্ত মাপকাঠির কারণে পূর্বাভাসের ফলাফল প্রদান করা না গেলে অথবা প্রোডাক্টে কোনও আপডেট করা না গেলে এটি প্রয়োজন হয়। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিওতে প্রযোজ্য।
product.frequencyCap

object (FrequencyCap)

শুধু আউটপুট। ক্রেতার বেছে নেওয়া ফ্রিকোয়েন্সি ক্যাপ। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিওতে প্রযোজ্য।
product.program

string

শুধু আউটপুট। যে প্রোগ্রামের অধীনে ক্রেতা ইনস্ট্যান্ট ডিল তৈরি করেছেন। এক্সচেঞ্জের রেগুলার ফ্লোয়ের জন্য খালি। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিওতে প্রযোজ্য।
product.buyerCustomParameters

map (key: string, value: string)

শুধু আউটপুট। ইনস্ট্যান্ট ডিল অনুরোধে ক্রেতার সেট করা কাস্টম কী/ভ্যালু প্যারামিটার। শুধুমাত্র ইনস্ট্যান্ট ডিল সিনারিওতে প্রযোজ্য।

"key": valueটি পেয়ারের তালিকা সহ অবজেক্ট। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }।
product.etag

string

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

string (FieldMask format)

কোন ফিল্ড আপডেট করতে হবে তা নিয়ন্ত্রণ করার মাস্ক। প্রয়োজনীয়।

এটি কমা দিয়ে আলাদা করা ফিল্ডের সম্পূর্ণ উপযুক্ত নামের তালিকা। উদাহরণ: "user.displayName,photo"।

প্রতিক্রিয়ার বডি

সফল হলে, প্রতিক্রিয়ার বডিতে একটি Product-এর ইন্সট্যান্স থাকে।

অনুমোদনের স্কোপ

এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

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

আরও তথ্যের জন্য, OAuth 2.0 Overview দেখুন।