دارایی را آپلود می کند. در صورت موفقیت آمیز بودن، شناسه دارایی تازه آپلود شده را برمی گرداند. اندازه فایل دارایی نباید بیشتر از 10 مگابایت برای تصاویر، 200 مگابایت برای فایل های ZIP و 1 گیگابایت برای ویدئوها باشد.
باید در فرآیند آپلود رسانه چندبخشی استفاده شود. نمونههایی از کتابخانههای مشتری ارائه شده را میتوانید در راهنمای Creating Creatives ما پیدا کنید.
درخواست HTTP
- URI آپلود، برای درخواست های آپلود رسانه:
POST https://displayvideo.googleapis.com/upload/v1/advertisers/{advertiserId}/assets
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
advertiserId | مورد نیاز. شناسه تبلیغکنندهای که این دارایی به آن تعلق دارد. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "filename": string } |
فیلدها | |
---|---|
filename | مورد نیاز. نام فایل دارایی، از جمله پسوند فایل. نام فایل باید UTF-8 با حداکثر اندازه 240 بایت رمزگذاری شده باشد. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
یک پیام پاسخ برای assets.upload
.
نمایندگی JSON |
---|
{
"asset": {
object ( |
فیلدها | |
---|---|
asset | دارایی آپلود شده، در صورت موفقیت. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/display-video
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.