Playlists: update

Modifica una lista de reproducción. Por ejemplo, puede cambiar el título, la descripción o el estado de la privacidad. Pruébalo ahora.

Solicitud

Solicitud HTTP

PUT https://www.googleapis.com/youtube/v3/playlists

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).

Alcance
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube

Parámetros

La tabla a continuación muestra los parámetros compatibles con esta consulta. Todos los parámetros mencionados son parámetros de consulta.

Parámetros
Parámetros obligatorios
part string
El parámetro part sirve para dos propósitos en esta operación. Identifica las propiedades que establecerá la operación de escritura, así como las propiedades que incluirá la respuesta de la API.

Los nombres de part que se pueden incluir en el valor del parámetro son snippet y status.

Ten en cuenta que este método anulará los valores existentes para todas las propiedades que pueden modificarse que se encuentran en cualquiera de las partes que especifica el valor del parámetro. Por ejemplo, la configuración de privacidad de una lista de reproducción se encuentra en la parte status. Si tu solicitud es la actualización de una lista de reproducción privada y el valor del parámetro part de la solicitud incluye la par­te status, la configuración de privacidad de la lista de reproducción se actualizará según el valor que especifica el cuerpo de la solicitud. Si el cuerpo de la solicitud no especifica un valor, la configuración de privacidad existente se elimina y la lista de reproducción vuelve a la configuración de privacidad predeterminada.

Cuerpo de la solicitud

Proporciona un recurso de lista de reproducción en el cuerpo de la solicitud. Para ese recurso:

  • Debes especificar un valor para estas propiedades:

    • id
    • snippet.title

  • Puedes establecer los valores de las siguientes propiedades:

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • snippet.tags[]

    Si envías una solicitud de actualización sin especificar un valor para una propiedad que ya tiene un valor, el valor actual de la propiedad se eliminará.

Respuesta

Si se aplica correctamente, este método muestra un recurso de lista de reproducción en el cuerpo de la respuesta.

Errores

En la tabla a continuación se identifican los mensajes de error que la API podría mostrar en respuesta a una invocación a este método. Consulta la documentación sobre mensajes de error para obtener más información.

Tipo de error Detalle del error Descripción
invalidValue invalidPlaylistSnippet La solicitud proporciona un fragmento de una lista de reproducción no válido.
notFound playlistNotFound No se puede encontrar la lista de reproducción identificada con el parámetro id de la solicitud.
required playlistTitleRequired La solicitud debe especificar un título para la lista de reproducción.

¡Pruébalo!

Utiliza el Explorador de la API para invocar este método con datos en directo y ver la solicitud y la respuesta de la API.