پخش آگهی های جدید را به صورت دسته ای ایجاد می کند.
- حداکثر تعداد مجاز پخش آگهی در یک دسته 1000 است.
- در صورت موفقیت، آگهیهای تازه ایجاد شده را برمیگرداند.
- اگر واحد آگهی، سفارش، خط یا خلاقیت نامعتبر مشخص شده باشد، کد خطا
INVALID_ARGUMENTرا برمیگرداند. - اگر تبلیغی برای واحد تبلیغات، سفارش، خط و خلاقیت یکسان با زمان شروع یکسان از قبل وجود داشته باشد، کد خطا
ALREADY_EXISTSبرمیگرداند. - اگر واحد تبلیغاتی، سفارش، خط یا دارایی خلاقانه مشابهی پیدا نشد، کد خطا
NOT_FOUNDرا برمیگرداند. - اگر درخواست حاوی نام منبع و شناسه خارجی باشد، کد خطا
FAILED_PRECONDITIONرا برمیگرداند.
درخواست HTTP
POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها | |
|---|---|
parent | مورد نیاز. نام منبع فروشنده قالب: فروشندگان/{فروشنده} |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"requests": [
{
object ( |
| فیلدها | |
|---|---|
requests[] | مورد نیاز. تبلیغ برای ایجاد پخش می شود. حداکثر تعداد مجاز پخش آگهی در یک دسته 1000 است. زمان شروع باید در گذشته و حداکثر 3 روز قبل از تاریخ ایجاد باشد. زمان پایان باید در گذشته و بعد از زمان شروع باشد. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پاسخ برای ایجاد نمایش های تبلیغاتی به صورت دسته ای.
| نمایندگی JSON |
|---|
{
"adPlays": [
{
object ( |
| فیلدها | |
|---|---|
adPlays[] | آگهی پخش می شود که ایجاد شد. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/doubleclickbidmanager
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
CreateAdPlayRequest
درخواست پیام برای AdPlayService.CreateAdPlay.
| نمایندگی JSON |
|---|
{
"parent": string,
"adPlay": {
object ( |
| فیلدها | |
|---|---|
parent | مورد نیاز. نام منبع فروشنده قالب: فروشندگان/{فروشنده} |
adPlay | مورد نیاز. پخش آگهی برای ایجاد. نام پخش آگهی توسط سیستم تولید می شود و نباید تنظیم شود. زمان شروع باید در گذشته و حداکثر 3 روز قبل از تاریخ ایجاد باشد. زمان پایان باید در گذشته و بعد از زمان شروع باشد. |