LiveCuepoints: insert
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تم إيقاف هذه الطريقة واستبدالها بالطريقة liveBroadcasts.cuepoint.
لإدراج نقطة تلميح في بث مباشر. وفي الوقت الحالي، يجب أن يكون الحساب المرتبط بحساب مالك المحتوى على YouTube
معتمدًا في هذه الطريقة.
طلب
طلب HTTP
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
التفويض
ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).
| النطاق |
|---|
https://www.googleapis.com/auth/youtubepartner |
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
| المعلَمات |
| المعلّمات المطلوبة |
channelId |
string
تُحدّد المَعلمة channelId القناة التي تملك البث الذي يتمّ استخدامه لعرض البث المباشر. |
onBehalfOfContentOwner |
string
تحدّد المعلمة onBehalfOfContentOwner مالك المحتوى الذي يتصرف المستخدم نيابةً عنه. |
نص الطلب
قدِّم مورد liveCuepoint في نص الطلب.
بالنسبة إلى هذا المورد:
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
| نوع الخطأ |
تفاصيل الخطأ |
الوصف |
invalidValue (400) |
conflictingTimeFields |
يمكن تحديد خاصية واحدة فقط من offsetTimeMs وwalltime. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-02-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2023-02-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis API method for inserting a cuepoint into a live broadcast has been deprecated and is now replaced by the \u003ccode\u003eliveBroadcasts.cuepoint\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eUsing this method requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/youtubepartner\u003c/code\u003e scope and being associated with a YouTube Content Owner.\u003c/p\u003e\n"],["\u003cp\u003eThe required parameters for this method are \u003ccode\u003echannelId\u003c/code\u003e, which identifies the channel owning the broadcast, and \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e, which identifies the content owner.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a \u003ccode\u003eliveCuepoint\u003c/code\u003e resource with specified values for \u003ccode\u003ebroadcastId\u003c/code\u003e and \u003ccode\u003esettings.cueType\u003c/code\u003e, and can optionally set \u003ccode\u003esettings.offsetTimeMs\u003c/code\u003e, \u003ccode\u003esettings.walltime\u003c/code\u003e, or \u003ccode\u003esettings.durationSecs\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe API returns a \u003ccode\u003eliveCuepoint\u003c/code\u003e resource upon success, and an error, such as \u003ccode\u003einvalidValue (400)\u003c/code\u003e for \u003ccode\u003econflictingTimeFields\u003c/code\u003e is returned if there are any errors.\u003c/p\u003e\n"]]],["This API method, now deprecated, was used to insert a cuepoint into a live broadcast via a POST request to `https://www.googleapis.com/youtube/partner/v1/liveCuepoints`. Authorization via the `https://www.googleapis.com/auth/youtubepartner` scope was required. Requests needed the `channelId` and `onBehalfOfContentOwner`. The request body required the `broadcastId` and `settings.cueType` properties to be set in a `liveCuepoint` resource. One of `offsetTimeMs` and `walltime` is valid. A successful response returned the `liveCuepoint` resource.\n"],null,["# LiveCuepoints: insert\n\nThis method has been deprecated and replaced by the\n[liveBroadcasts.cuepoint](/youtube/v3/live/docs/liveBroadcasts/cuepoint) method.\nInserts a cuepoint into a live broadcast. Currently, requests to this\nmethod must be authorized by an account associated with a YouTube\nContent Owner.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/youtube/partner/v1/liveCuepoints\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/youtube/v3/live/authentication)).\n\n| Scope |\n|--------------------------------------------------|\n| `https://www.googleapis.com/auth/youtubepartner` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `channelId` | `string` The **channelId** parameter identifies the channel that owns the broadcast into which the cuepoint is being inserted. |\n| `onBehalfOfContentOwner` | `string` The **onBehalfOfContentOwner** parameter identifies the content owner that the user is acting on behalf of. |\n\n### Request body\n\nProvide a [liveCuepoint resource](/youtube/v3/live/docs/liveCuepoints#resource) in the request body.\nFor that resource:\n\n- You must specify a value for these properties:\n\n \u003cbr /\u003e\n\n - `broadcastId`\n - `settings.cueType`\n\n \u003cbr /\u003e\n\n- You can set values for these properties:\n\n \u003cbr /\u003e\n\n - `settings.offsetTimeMs`\n - `settings.walltime`\n - `settings.durationSecs`\n\n \u003cbr /\u003e\n\nResponse\n--------\n\nIf successful, this method returns a [liveCuepoint resource](/youtube/v3/live/docs/liveCuepoints#resource) in the response body.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. Please see the [error message](/youtube/v3/live/docs/errors) documentation for more detail.\n\n| Error type | Error detail | Description |\n|----------------------|-------------------------|-------------------------------------------------------------|\n| `invalidValue (400)` | `conflictingTimeFields` | Only one of `offsetTimeMs` and `walltime` may be specified. |"]]
