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
    },
    "etag": string
  },
  "updateMask": string
}
ক্ষেত্র
product.displayName

string

পণ্যের প্রদর্শনের নাম।

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

product.externalDealId

string

বাহ্যিক আইডি। এটি এক্সচেঞ্জ সিস্টেমে ডিল আইডি। সর্বোচ্চ 100টি অক্ষর। অনুমোদিত অক্ষরগুলি হল আলফানিউমেরিক, আন্ডারস্কোর, ড্যাশ এবং ডট৷ সমস্ত পণ্য জুড়ে অনন্য হতে হবে. প্রয়োজন।

product.transactionType

enum ( TransactionType )

পণ্য লেনদেনের ধরন। প্রয়োজন।

product.pricingType

enum ( PricingType )

পণ্যের জন্য মূল্যের ধরন। প্রয়োজন।

product.updateTime
(deprecated)

string ( Timestamp format)

টাইমস্ট্যাম্প যখন পণ্যটি সর্বশেষ আপডেট করা হয়েছিল।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

product.startTime

string ( Timestamp format)

এই পণ্যটি সক্রিয় হওয়ার সময়। শেষ সময়ের আগে হতে হবে। শুরুর সময় ভবিষ্যতে 1 বছরের বেশি হতে পারে না। প্রয়োজন।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

product.endTime

string ( Timestamp format)

এই পণ্যটি নিষ্ক্রিয় হওয়ার সময়। বর্তমানে 2036 সালের পরে হতে পারে না। প্রয়োজনীয়।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "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 )

একটি পণ্যের জন্য মাঝারি ধরনের. পিছন দিকে সামঞ্জস্যের জন্য নির্দিষ্ট না থাকলে ডিজিটালে ডিফল্ট। পণ্য তৈরির পরে পরিবর্তন করা যাবে না।

product.audienceTargetingConfig

object ( AudienceTargetingConfig )

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

product.targetingCriteria

object ( TargetingCriteria )

শুধুমাত্র আউটপুট। পণ্য টার্গেটিং মানদণ্ড রেফারেন্স. শুধুমাত্র তাত্ক্ষণিক ডিল পরিস্থিতিতে প্রযোজ্য.

product.forecastResult

object ( ForecastResult )

পণ্য পূর্বাভাস ফলাফল. যখন লক্ষ্য নির্ধারণের মানদণ্ড খালি না থাকে এবং পূর্বাভাস দেওয়া হয় না তখন প্রয়োজনীয়। শুধুমাত্র তাত্ক্ষণিক ডিল পরিস্থিতিতে প্রযোজ্য.

product.errorDetails

object ( ErrorDetails )

নির্দিষ্ট পণ্য ক্ষেত্র আপডেট করা যাবে না যখন ত্রুটি বিবরণ নির্দিষ্ট করা আবশ্যক. যখন লক্ষ্যমাত্রার মাপকাঠির কারণে পূর্বাভাসের ফলাফল প্রদান করা যায় না বা পণ্যটিতে আপডেট করা যায় না তখন প্রয়োজনীয়। শুধুমাত্র তাত্ক্ষণিক ডিল পরিস্থিতিতে প্রযোজ্য.

product.frequencyCap

object ( FrequencyCap )

শুধুমাত্র আউটপুট। ক্রেতা দ্বারা নির্বাচিত ফ্রিকোয়েন্সি ক্যাপ। শুধুমাত্র তাত্ক্ষণিক ডিল পরিস্থিতিতে প্রযোজ্য.

product.etag

string

একটি ইট্যাগ যা একটি পণ্য আপডেট করার সময় নির্দিষ্ট করা প্রয়োজন। এটি শুধুমাত্র একটি আপডেটের জন্য নির্দিষ্ট করা প্রয়োজন যদি etag ক্ষেত্র খালি না থাকে। শুধুমাত্র তাত্ক্ষণিক ডিল পরিস্থিতিতে প্রযোজ্য.

updateMask

string ( FieldMask format)

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

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo" ।

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

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

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

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

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

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