Method: files.create

Lädt eine Datei hoch, die in Media- oder Rich Card-Nachrichten verwendet werden soll.

Der Agent stellt die URL oder die Binärdatei der Datei und optional die URL der entsprechenden Miniaturansichtsdatei bereit.

Wichtig: Aus Gründen des Datenschutzes und der Sicherheit lädt die RCS for Business-Plattform Medien- und PDF-Dateien von den angegebenen URLs herunter und verarbeitet sie, bevor sie an den Nutzer gesendet werden. Dadurch wird verhindert, dass der Kundenservicemitarbeiter über eindeutige URLs nachverfolgt wird. Senden Sie daher nicht eine große Anzahl eindeutiger URLs. Die RCS for Business-Plattform unterstützt dies nicht, unabhängig davon, ob die URLs auf dieselben oder auf unterschiedliche Dateien verweisen. Verwenden Sie für identische Dateien dieselbe URL.

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

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

HTTP-Anfrage

  • Upload-URI für Media-Uploadanfragen:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • Metadaten-URI für reine Metadatenanfragen:
    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 verfügbare URL der Datei. Die RCS for Business-Plattform ermittelt den MIME-Typ der Datei anhand des Felds „content-type“ in den HTTP-Headern beim Abrufen der Datei. RCS for Business 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 Videocontent-Typen: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Unterstützte PDF-Inhaltstypen: application/pdf.

Hinweis: Eine Datei-URL kann eine Weiterleitung haben. Weitergeleitete Date-URLs müssen öffentlich zugänglich sein. Weiterleitungen werden für Datei-URLs in CreateAgentMessageRequest nicht unterstützt.
thumbnailUrl

string

Optional. Öffentlich verfügbare URL der Miniaturansicht, die der Datei entspricht. Wenn dieses Feld nicht festgelegt ist, wird automatisch eine Miniaturansicht aus der Datei generiert. Die RCS for Business-Plattform ermittelt den MIME-Typ der Datei anhand des Felds „content-type“ in den HTTP-Headern beim Abrufen der Datei.

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

string

Erforderlich. Die eindeutige ID des Agents.

Antworttext

Eine Dateiressource mit einem eindeutigen Namen, die ein Agent verwenden kann, um die Datei beim Senden von Nachrichten zu identifizieren.

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

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

string

Vom Server zugewiesener eindeutiger Name für die Dateiresource, mit der Agents die Datei beim Senden von Nachrichten identifizieren können. Das Format ist „files/{uid}“, wobei {uid} eine eindeutige ID ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.