LiveCuepoints: insert
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Ta metoda została wycofana i zastąpiona metodą liveBroadcasts.cuepoint.
Powoduje wstawienie punktu wstawienia do transmisji na żywo. Obecnie prośby o dostęp do tej metody muszą być autoryzowane przez konto powiązane z właścicielem treści w YouTube.
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
Parametry
W poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.
| Parametry |
| Parametry wymagane |
channelId |
string
Parametr channelId wskazuje kanał, do którego należy transmisja, do której wstawiono punkt wstawienia. |
onBehalfOfContentOwner |
string
Parametr onBehalfOfContentOwner wskazuje właściciela treści, w imieniu którego działa użytkownik. |
Treść żądania
Podaj zasób LiveCuepoint w treści żądania.
Dla tego zasobu:
Błędy
W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej informacji znajdziesz w dokumentacji komunikatów o błędach.
| Typ błędu |
Szczegóły błędu |
Opis |
invalidValue (400) |
conflictingTimeFields |
Możesz podać tylko jedną wartość offsetTimeMs i walltime. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-02-22 UTC.
[null,null,["Ostatnia aktualizacja: 2023-02-22 UTC."],[[["\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. |"]]
