Method: customEmojis.list

Elenca le emoji personalizzate visibili all'utente autenticato.

Le emoji personalizzate sono disponibili solo per gli account Google Workspace e l'amministratore deve attivarle per l'organizzazione. Per saperne di più, vedi Informazioni sulle emoji personalizzate in Google Chat e Gestire le autorizzazioni per le emoji personalizzate.

Richiede l'autenticazione dell'utente con uno dei seguenti ambiti di autorizzazione:

  • https://www.googleapis.com/auth/chat.customemojis.readonly
  • https://www.googleapis.com/auth/chat.customemojis

Richiesta HTTP

GET https://chat.googleapis.com/v1/customEmojis

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di emoji personalizzate restituite. Il servizio può restituire meno emoji personalizzate rispetto a questo valore. Se non specificato, il valore predefinito è 25. Il valore massimo è 200; i valori superiori a 200 vengono modificati in 200.
pageToken

string

Facoltativo. (Se riprendi da una query precedente).

Un token di pagina ricevuto da una precedente chiamata dell'emoji personalizzata dell'elenco. Fornisci questo valore per recuperare la pagina successiva.

Quando viene visualizzata la paginazione, il valore del filtro deve corrispondere alla chiamata che ha fornito il token pagina. Se passi un valore diverso, potresti ottenere risultati imprevisti.
filter

string

Facoltativo. Un filtro per query.

Supporta i filtri per creator.

Per filtrare in base al creator, devi specificare un valore valido. Al momento, solo creator("users/me") e NOT creator("users/me") sono accettati per filtrare le emoji personalizzate in base al fatto che siano state create o meno dall'utente che chiama.

Ad esempio, la seguente query restituisce le emoji personalizzate create dall'utente che ha effettuato la chiamata:

creator("users/me")

Le query non valide vengono rifiutate con un errore INVALID_ARGUMENT.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Una risposta per elencare le emoji personalizzate.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "customEmojis": [
    {
      object (CustomEmoji)
    }
  ],
  "nextPageToken": string
}
Campi
customEmojis[]

object (CustomEmoji)

Elenco non ordinato. Elenco di emoji personalizzate.
nextPageToken

string

Un token che puoi inviare come pageToken per recuperare la pagina successiva dei risultati. Se è vuoto, non ci sono pagine successive.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.