API برای ایجاد محتوای جدید یا بهروزرسانی ابرداده آن در صورتی که محتوا از قبل در Ad Manager وجود داشته باشد. محتوا را در صورت موفقیت یا یک google.rpc.Code
در صورت شکست برمیگرداند.
یک نمونه درخواست به نظر می رسد:
{
"status": "ACTIVE",
"title": "Best video ever",
"updateTime": "2019-01-24T01:30:15.01Z",
"duration": "230s",
"cuePoints": ["55.532s", "192s"],
"publishTime": "2019-01-24T01:30:15.01Z",
"thumbnailUrl": "http://www.domain.com/tn.jpg",
"metadata": {
"keyValues": {
"category": "sports",
"tag": ["soccer", "messi"],
}
}
}
درخواست HTTP
PUT https://admanagervideo.googleapis.com/v1/videoContent/{videoContent.name=networks/*/sources/*/content/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
videoContent.name | فقط خروجی نام منبع محتوای ویدیویی. فرمت این فیلد به شرح زیر است: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' network_code کد شبکه در Google Ad Manager است که این محتوا به آن تعلق دارد. content_source_id شناسه منبع محتوا در Google Ad Manager است که این محتوا باید به آن تعلق داشته باشد. cms_content_id شناسه محتوای CMS در Google Ad Manager است که بهعنوان بخشی از درخواست آگهی برای شناسایی تبلیغاتی که Ad Manager میتواند در مقابل ویدیوی مربوطه ارائه کند، تشکیل شده است. این مقدار می تواند عددی یا الفبایی باشد. |
درخواست بدن
بدنه درخواست شامل نمونه ای از VideoContent
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از VideoContent
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/contentingestion
-
https://www.googleapis.com/auth/video-ads
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.