Method: users.drafts.create
Crea un nuevo borrador con la etiqueta DRAFT
.
Solicitud HTTP
- URI de carga para solicitudes de carga de contenido multimedia:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/drafts
- URI de metadatos, para solicitudes solo de metadatos:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
userId |
string
La dirección de correo electrónico del usuario. Se puede usar el valor especial me para indicar el usuario autenticado.
|
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de Draft
.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Draft
.
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
Para obtener más información, consulta la guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-05 (UTC)
[null,null,["Última actualización: 2024-09-05 (UTC)"],[[["Creates a new draft with the `DRAFT` label, allowing for both media upload and metadata-only requests."],["Requires providing the user's email address (`userId`) as a path parameter, with `me` indicating the authenticated user."],["The request and response bodies utilize the `Draft` object for data exchange."],["Needs authorization with specific OAuth scopes, including `https://mail.google.com/`, `https://www.googleapis.com/auth/gmail.modify`, or `https://www.googleapis.com/auth/gmail.compose`."]]],["This content outlines how to create a new draft in Gmail's API. It involves sending a `POST` request to either a media upload URI (`/upload/`) or a metadata URI (`/`). The `userId` path parameter, representing the user's email, is required; `me` represents the authenticated user. The request and response bodies both utilize the `Draft` instance. Authorization requires specific OAuth scopes: `mail.google.com/`, `gmail.modify`, or `gmail.compose`.\n"]]