LiveCuepoints: insert
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo metodo è stato ritirato e sostituito dal metodo liveBroadcasts.cuepoint.
Inserisce un cue point in una trasmissione dal vivo. Attualmente, le richieste a questo metodo devono essere autorizzate da un account associato a un proprietario dei contenuti di YouTube.
Risorse richieste:
Richiesta HTTP
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
Parametri
Nella tabella seguente sono elencati i parametri supportati dalla query. Tutti i parametri elencati sono parametri di ricerca.
| Parametri |
| Parametri obbligatori |
channelId |
string
Il parametro channelId identifica il canale proprietario della trasmissione in cui viene inserito il cue point. |
onBehalfOfContentOwner |
string
Il parametro onBehalfOfContentOwner identifica il proprietario dei contenuti per conto del quale l'utente agisce. |
Corpo della richiesta
Fornisci una risorsa liveCuepoint nel corpo della richiesta.
Per la risorsa:
Risposta
In caso di esito positivo, questo metodo restituisce una risorsa liveCuepoint nel corpo della risposta.
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta la documentazione sui messaggi di errore.
| Tipo di errore |
Dettagli errore |
Descrizione |
invalidValue (400) |
conflictingTimeFields |
È possibile specificare solo uno tra offsetTimeMs e walltime. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2023-02-22 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
