LiveCuepoints: insert
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esse método foi descontinuado e substituído pelo
método liveBroadcasts.cuepoint.
Insere um marcador em uma transmissão ao vivo. Atualmente, as solicitações para esse método precisam ser autorizadas por uma conta associada a um proprietário do conteúdo do YouTube.
Solicitação
Solicitação HTTP
POST https://www.googleapis.com/youtube/partner/v1/liveCuepoints
Parâmetros
A tabela a seguir lista os parâmetros compatíveis com essa consulta. Todos os parâmetros listados são os parâmetros de consulta.
| Parâmetros |
| Parâmetros obrigatórios |
channelId |
string
O parâmetro channelId identifica o canal que tem a transmissão em que o marcador está sendo inserido. |
onBehalfOfContentOwner |
string
O parâmetro onBehalfOfContentOwner identifica o proprietário do conteúdo em nome do qual o usuário está agindo. |
Corpo da solicitação
Forneça um recurso liveCuepoint no corpo da solicitação.
Para esse recurso:
Erros
A tabela a seguir identifica mensagens de erro que a API pode retornar em resposta a uma chamada para esse método. Consulte a documentação mensagem de erro para mais detalhes.
| Tipo de erro |
Detalhe do erro |
Descrição |
invalidValue (400) |
conflictingTimeFields |
Somente uma entre offsetTimeMs e walltime pode ser especificada. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2023-02-22 UTC.
[null,null,["Última atualização 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. |"]]
