Method: files.create

Carica un file da utilizzare nei messaggi multimediali o nelle schede interattive.

L'agente fornisce l'URL o il programma binario del file e, facoltativamente, l'URL del file della miniatura corrispondente. La piattaforma RBM memorizza il file nella cache per 30 giorni e restituisce un nome univoco che puoi utilizzare per identificare il file quando invii i messaggi dell'agente.

Per caricare un file binario, effettua una richiesta POST HTTP all'URI di caricamento, ometti il campo fileUrl dal corpo della richiesta JSON e specifica il programma binario come corpo della richiesta POST. Ad esempio, utilizza il flag cURL --upload-file con il percorso completo del file binario.

Richiesta HTTP

  • URI di caricamento, per le richieste di caricamento di contenuti multimediali:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI metadati, per richieste di soli metadati:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "contentDescription": string,
  "agentId": string
}
Campi
fileUrl

string

Campo facoltativo. URL disponibile pubblicamente del file. La piattaforma RBM determina il tipo MIME del file dal campo content-type nelle intestazioni HTTP al momento del recupero del file.

Tipi di contenuti di immagine supportati: image/jpeg, image/jpg, image/gif, image/png.

Tipi di contenuti video supportati: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.
thumbnailUrl

string

Campo facoltativo. URL disponibile pubblicamente della miniatura corrispondente al file. Se questo campo non viene impostato, la piattaforma RBM genera automaticamente una miniatura dal file. La piattaforma RBM determina il tipo MIME del file dal campo content-type nelle intestazioni HTTP al momento del recupero del file.

Tipi di contenuti di immagine supportati: image/jpeg, image/jpg, image/gif, image/png.
contentDescription

string

Campo facoltativo. Descrizione testuale dei contenuti del file. Gli screen reader utilizzano questa descrizione per aiutare gli utenti con disabilità a comprendere il contenuto del file.
agentId

string

Obbligatorio. L'identificatore univoco dell'agente.

Corpo della risposta

Una risorsa file con un nome univoco che un agente può utilizzare per identificare il file durante l'invio di messaggi.

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

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Nome univoco assegnato dal server della risorsa file, che un agente può utilizzare per identificare il file durante l'invio di messaggi. Il formato è "files/{uid}", dove {uid} è un ID univoco.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.