Method: files.create

Dateien werden hochgeladen, um sie in Nachrichten mit Medien oder Rich Cards zu verwenden.

Der Agent stellt die URL oder das Binärformat der Datei und (optional) die URL der entsprechenden Miniaturansichtsdatei bereit.

Wichtig: Aus Gründen des Datenschutzes und der Sicherheit der Nutzer lädt die RBM-Plattform Medien- und PDF-Dateien von den angegebenen URLs herunter und verarbeitet sie, bevor sie an den Nutzer gesendet werden. Dadurch wird das Tracking von Kundenservicemitarbeitern über eindeutige URLs verhindert. Reichen Sie daher nicht zu viele eindeutige URLs ein. Die RBM-Plattform unterstützt dies nicht, unabhängig davon, ob die URLs auf dieselben oder unterschiedliche Dateien verweisen. Verwenden Sie für identische Dateien dieselbe URL.

Die RBM-Plattform speichert die Datei 60 Tage lang im Cache und gibt einen eindeutigen Namen zurück, mit dem Sie die Datei beim Senden von Kundenservicemitarbeiternachrichten identifizieren können.

Wenn Sie eine Binärdatei hochladen möchten, senden Sie eine HTTP-POST-Anfrage an den Upload-URI, lassen Sie das Feld fileUrl aus dem JSON-Anfragetext aus und geben Sie das Binärformat als POST-Anfragetext an. Verwenden Sie beispielsweise das cURL-Flag --upload-file mit dem voll qualifizierten Dateipfad der Binärdatei.

HTTP-Anfrage

  • Upload-URI für Anfragen zum Hochladen von Medien:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • Metadaten-URI für Anfragen, die nur Metadaten enthalten:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
Felder
fileUrl

string

Optional. Öffentlich zugängliche URL der Datei. Die RBM-Plattform ermittelt den MIME-Typ der Datei beim Abrufen anhand des „content-type“-Felds in den HTTP-Headern. RBM unterstützt Bilder, Audio, Video und PDF.

Unterstützte Bildinhaltstypen: image/jpeg, image/jpg, image/gif, image/png.

Unterstützte Audioinhaltstypen: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

Unterstützte Videocontenttypen: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Unterstützte PDF-Inhaltstypen: application/pdf.

Hinweis: Die Datei-URL kann eine Weiterleitung enthalten. Die URLs der weitergeleiteten Dateien müssen öffentlich zugänglich sein. Weiterleitungen werden für Datei-URLs in CreateAgentMessageRequest nicht unterstützt.
thumbnailUrl

string

Optional. Öffentlich zugängliche URL der Miniaturansicht, die der Datei entspricht. Wenn dieses Feld nicht festgelegt ist, generiert die RBM-Plattform automatisch ein Thumbnail aus der Datei. Die RBM-Plattform ermittelt den MIME-Typ der Datei beim Abrufen anhand des „content-type“-Felds in den HTTP-Headern.

Unterstützte Bildinhaltstypen: image/jpeg, image/jpg, image/gif, image/png.
agentId

string

Erforderlich. Die eindeutige Kennung des Kundenservicemitarbeiters.

Antworttext

Eine Dateiressource mit einem eindeutigen Namen, mit dem ein Kundenservicemitarbeiter die Datei beim Senden von Nachrichten identifizieren kann.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "name": string
}
Felder
name

string

Der vom Server zugewiesene eindeutige Name der Dateiressource, mit dem ein Kundenservicemitarbeiter die Datei beim Senden von Nachrichten identifizieren kann. Das Format ist „files/{uid}“, wobei {uid} eine eindeutige Kennung ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.