Method: files.create

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

L'agente fornisce l'URL o il file binario e (facoltativamente) l'URL del file miniatura corrispondente.

Importante: per la privacy e la sicurezza degli utenti, la piattaforma RCS for Business scarica ed elabora i file multimediali e PDF dagli URL forniti prima di inviarli all'utente. In questo modo si impedisce il monitoraggio degli agenti tramite URL univoci. Pertanto, non inviare un volume elevato di URL univoci. La piattaforma RCS for Business non supporta questa operazione, indipendentemente dal fatto che gli URL indirizzino allo stesso file o a file diversi. Utilizza lo stesso URL per i file identici.

La piattaforma RCS for Business memorizza nella cache il file per 60 giorni e restituisce un nome univoco che puoi utilizzare per identificare il file quando invii messaggi dell'agente.

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

Richiesta HTTP

  • URI di caricamento, per le richieste di caricamento dei contenuti multimediali:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI dei metadati, per le richieste solo di 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,
  "agentId": string
}
Campi
fileUrl

string

Facoltativo. URL pubblicamente disponibile del file. La piattaforma RCS for Business determina il tipo MIME del file dal campo Content-Type nelle intestazioni HTTP durante il recupero del file. RCS for Business supporta immagini, audio, video e PDF.

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

Tipi di contenuti audio supportati: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

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

Tipi di contenuti PDF supportati: application/pdf.

Nota: un URL di file può avere un reindirizzamento. Gli URL dei file reindirizzati devono essere accessibili pubblicamente. I reindirizzamenti non sono supportati per gli URL dei file in CreateAgentMessageRequest.
thumbnailUrl

string

Facoltativo. URL disponibile pubblicamente della miniatura corrispondente al file. Se questo campo non è impostato, la piattaforma RCS for Business genera automaticamente una miniatura dal file. La piattaforma RCS for Business determina il tipo MIME del file dal campo Content-Type nelle intestazioni HTTP durante il recupero del file.

Tipi di contenuti immagine supportati: image/jpeg, image/jpg, image/gif, image/png.
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 quando invia 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 per la risorsa file che gli agenti possono utilizzare per identificare il file quando inviano 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 OAuth 2.0 Overview.