Method: files.create

Importe un fichier à utiliser dans les messages multimédias ou les messages de type carte enrichie.

L'agent fournit l'URL ou le binaire du fichier, ainsi que (facultativement) l'URL du fichier de vignette correspondant.

Important : Pour protéger la confidentialité et la sécurité des utilisateurs, la plate-forme RCS pour les entreprises télécharge et traite les fichiers multimédias et PDF à partir des URL fournies avant de les envoyer à l'utilisateur. Cela empêche le suivi des agents par des URL uniques. Par conséquent, ne soumettez pas un grand nombre d'URL uniques. La plate-forme RCS for Business n'est pas compatible avec cette pratique, que les URL pointent vers les mêmes fichiers ou vers des fichiers différents. Utilisez la même URL pour les fichiers identiques.

La plate-forme RCS for Business met en cache le fichier pendant 60 jours et renvoie un nom unique que vous pouvez utiliser pour identifier le fichier lorsque vous envoyez des messages d'agent.

Pour importer un fichier binaire, envoyez une requête HTTP POST à l'URI d'importation, omettez le champ fileUrl du corps de la requête JSON et spécifiez le binaire comme corps de la requête POST. Par exemple, utilisez l'indicateur cURL --upload-file avec le chemin d'accès complet au fichier binaire.

Requête HTTP

  • URI d'importation pour les demandes d'importation de contenus multimédias :
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI des métadonnées pour les requêtes de métadonnées uniquement :
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
Champs
fileUrl

string

Facultatif. URL publiquement accessible du fichier. La plate-forme RCS for Business détermine le type MIME du fichier à partir du champ "content-type" des en-têtes HTTP lors de la récupération du fichier. RCS for Business accepte les images, les fichiers audio, les vidéos et les PDF.

Types de contenu image acceptés : image/jpeg, image/jpg, image/gif, image/png.

Types de contenu audio acceptés : audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

Types de contenus vidéo acceptés : video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Types de contenu PDF acceptés : application/pdf.

Remarque : Une URL de fichier peut comporter une redirection. Les URL de fichiers redirigées doivent être accessibles au public. Les redirections ne sont pas acceptées pour les URL de fichiers dans CreateAgentMessageRequest.
thumbnailUrl

string

Facultatif. URL publique de la miniature correspondant au fichier. Si ce champ n'est pas défini, la plate-forme RCS pour les entreprises génère automatiquement une miniature à partir du fichier. La plate-forme RCS for Business détermine le type MIME du fichier à partir du champ "content-type" des en-têtes HTTP lors de la récupération du fichier.

Types de contenu image acceptés : image/jpeg, image/jpg, image/gif, image/png.
agentId

string

Obligatoire. Identifiant unique de l'agent.

Corps de la réponse

Ressource de fichier avec un nom unique qu'un agent peut utiliser pour identifier le fichier lors de l'envoi de messages.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "name": string
}
Champs
name

string

Nom unique attribué par le serveur à la ressource de fichier. Les agents peuvent l'utiliser pour identifier le fichier lorsqu'ils envoient des messages. Le format est "files/{uid}", où {uid} est un ID unique.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.