اعتبارًا من
8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
Method: advertisers.assets.upload
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لتحميل مادة عرض تعرِض هذه السمة رقم تعريف مادة العرض التي تم تحميلها حديثًا في حال نجاح العملية. يجب ألا يزيد حجم ملف مادة العرض عن 10 ميغابايت للصور و200 ميغابايت لملفات ZIP و1 غيغابايت للفيديوهات.
يجب استخدامها في عملية تحميل الوسائط المتعدّدة الأجزاء. يمكن العثور على أمثلة لاستخدام مكتبات البرامج المقدَّمة في دليل إنشاء تصميمات الإعلانات.
طلب HTTP
- عنوان URL لتحميل طلبات تحميل الوسائط:
POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/assets
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
advertiserId |
string (int64 format)
مطلوب. معرّف المعلِن الذي تنتمي إليه مادة العرض.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"filename": string
} |
| الحقول |
filename |
string
مطلوب. اسم ملف مادة العرض، بما في ذلك امتداد الملف يجب أن يكون اسم الملف بترميز UTF-8 وبحجم أقصاه 240 بايت.
|
نص الاستجابة
رسالة ردّ لـ "assets.upload"
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"asset": {
object (Asset)
}
} |
| الحقول |
asset |
object (Asset)
مادة العرض المحمَّلة، في حال نجاح عملية التحميل
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: advertisers.assets.upload\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CreateAssetResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUploads an asset. Returns the ID of the newly uploaded asset if successful. The asset file size should be no more than 10 MB for images, 200 MB for ZIP files, and 1 GB for videos.\n\nMust be used within the [multipart media upload process](/display-video/api/guides/how-tos/upload#multipart). Examples using provided client libraries can be found in our [Creating Creatives guide](/display-video/api/guides/creating-creatives/overview#upload_an_asset).\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/assets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the advertiser this asset belongs to. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------|\n| ``` { \"filename\": string } ``` |\n\n| Fields ||\n|------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `filename` | `string` Required. The filename of the asset, including the file extension. The filename must be UTF-8 encoded with a maximum size of 240 bytes. |\n\n### Response body\n\nA response message for [assets.upload](/display-video/api/reference/rest/v4/advertisers.assets/upload#google.ads.displayvideo.v4.AssetService.CreateAsset).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"asset\": { object (/display-video/api/reference/rest/v4/advertisers.creatives#Asset) } } ``` |\n\n| Fields ||\n|---------|---------------------------------------------------------------------------------------------------------------------------|\n| `asset` | `object (`[Asset](/display-video/api/reference/rest/v4/advertisers.creatives#Asset)`)` The uploaded asset, if successful. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
