یک محصول را به روز می کند.
درخواست HTTP
PATCH https://dv360seller.googleapis.com/v1beta1/{product.name=exchanges/*/orders/*/products/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
product.name | نام مسیر نسبی برای محصول. تولید شده توسط سرور مثال: "exchanges/1234/orders/5678/products/abc". فقط خروجی |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "product": { "name": string, "displayName": string, "externalDealId": string, "transactionType": enum ( |
فیلدها | |
---|---|
product.displayName | نام نمایشی محصول باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود. مورد نیاز. |
product.externalDealId | شناسه خارجی این شناسه معامله در سیستم صرافی است. حداکثر 100 کاراکتر کاراکترهای مجاز عبارتند از حروف عددی، زیرخط، خط تیره و نقطه. باید در همه محصولات منحصر به فرد باشد. مورد نیاز. |
product.transactionType | نوع معامله محصول مورد نیاز. |
product.pricingType | نوع قیمت گذاری برای محصول مورد نیاز. |
product.updateTime | مهر زمانی آخرین به روز رسانی محصول. از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثالها: |
product.startTime | زمانی که این محصول فعال می شود. باید زودتر از پایان زمان باشد. زمان شروع نمی تواند بیش از 1 سال در آینده باشد. مورد نیاز. از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثالها: |
product.endTime | زمانی که این محصول غیر فعال می شود. در حال حاضر نمی تواند بعد از سال 2036 باشد. الزامی است. از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثالها: |
product.rateDetails | امتیاز دادن به جزئیات مورد نیاز. |
product.creativeConfig[] | الزامات خلاقانه برای یک محصول برای محصول نوع معامله رزرو شده مورد نیاز است. |
product.makegood | نشان می دهد که آیا یک محصول یک محصول ساختگی است یا خیر. |
product.makegoodDetails | جزئیات ساخت خوب برای یک محصول زمانی که محصول کالای اولیه است الزامی است. |
product.creativeSource | منبع خلاقانه برای یک محصول اختیاری، پیشفرض CREATIVE_SOURCE_ADVERTISER است. پس از ایجاد محصول قابل تغییر نیست. |
product.mediumType | نوع متوسط برای یک محصول اگر برای سازگاری با عقب مشخص نشده باشد، پیشفرض به DIGITAL تبدیل میشود. پس از ایجاد محصول قابل تغییر نیست. |
product.audienceTargetingConfig | اختیاری. پیکربندی هدفگیری مخاطب انتخاب شده در سطح معامله در Exchange اعمال شد. |
product.targetingCriteria | فقط خروجی مرجع معیارهای هدف گذاری محصول فقط برای سناریوهای معامله فوری قابل اجرا است. |
product.forecastResult | نتایج پیش بینی محصول زمانی که معیارهای هدف گذاری خالی نباشد و پیش بینی ارائه نشده باشد، الزامی است. فقط برای سناریوهای معامله فوری قابل اجرا است. |
product.errorDetails | هنگامی که فیلدهای محصول خاصی را نمی توان به روز کرد، جزئیات خطا باید مشخص شود. زمانی که نتیجه پیشبینی به دلیل معیار هدفیابی ارائه نشود یا بهروزرسانی برای محصول امکانپذیر نباشد، الزامی است. فقط برای سناریوهای معامله فوری قابل اجرا است. |
product.frequencyCap | فقط خروجی سقف فرکانس انتخاب شده توسط خریدار. فقط برای سناریوهای معامله فوری قابل اجرا است. |
product.etag | برچسبی که باید هنگام به روز رسانی محصول مشخص شود. فقط در صورتی که فیلد etag خالی نباشد باید برای به روز رسانی مشخص شود. فقط برای سناریوهای معامله فوری قابل اجرا است. |
updateMask | ماسکی برای کنترل اینکه کدام فیلدها به روز شوند. مورد نیاز. این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Product
است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/doubleclickbidmanager
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .