Method: spaces.messagePins.list

Enumera los mensajes fijados en un espacio. Los usuarios pueden fijar mensajes importantes en los espacios para acceder a ellos fácilmente. Para obtener más información, consulta Cómo fijar o desfijar una conversación en Google Chat.

Requiere autenticación del usuario con uno de los siguientes alcances de autorización:

  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces

Solicitud HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/messagePins

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el espacio principal que posee la colección de elementos fijados. Formato: spaces/{space}

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Es la cantidad máxima de mensajes fijados que se devuelven. Es posible que el servicio devuelva menos mensajes que este valor. El valor máximo es 100. Si usas un valor superior a 100, se cambiará automáticamente a 100. Si no se especifica, se devolverán, como máximo, 100 mensajes fijados. Los valores negativos muestran un error INVALID_ARGUMENT.
pageToken

string

Opcional. Es un token de página que se recibió de una llamada a list message pins anterior. Proporciona este parámetro para recuperar la página siguiente.

Cuando se realiza la paginación, todos los demás parámetros proporcionados deben guardar correspondencia con la llamada que proporcionó el token de página. Si pasas valores diferentes a los otros parámetros, es posible que obtengas resultados inesperados.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el mensaje de respuesta para enumerar los pines de mensajes.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "messagePins": [
    {
      object (MessagePin)
    }
  ],
  "nextPageToken": string
}
Campos
messagePins[]

object (MessagePin)

Son los mensajes fijados del espacio especificado.
nextPageToken

string

Puedes enviar un token como pageToken para recuperar la siguiente página de resultados. Si está vacío, no hay páginas siguientes.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly

Para obtener más información, consulta la Guía de autorización.