new_releases Updates: In den
Versionshinweisen finden Sie Informationen zu neuen Funktionen und Produktupdates.
Method: files.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eThis process allows agents to upload files, including images, audio, video, and PDFs, for use in media or rich card messages, either by providing a public URL or the file's binary data.\u003c/p\u003e\n"],["\u003cp\u003eThe RBM platform handles file privacy and security by downloading and processing media files from provided URLs, preventing agent tracking via unique URLs, and caches the file for 60 days.\u003c/p\u003e\n"],["\u003cp\u003eThe file upload requires an HTTP POST request to either the upload URI \u003ccode\u003ehttps://rcsbusinessmessaging.googleapis.com/upload/v1/files\u003c/code\u003e or the metadata-only URI \u003ccode\u003ehttps://rcsbusinessmessaging.googleapis.com/v1/files\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe agent can provide a public \u003ccode\u003efileUrl\u003c/code\u003e, \u003ccode\u003ethumbnailUrl\u003c/code\u003e, and must include the \u003ccode\u003eagentId\u003c/code\u003e within the request body to upload files.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful upload, the RBM platform returns a unique file name (\u003ccode\u003ename\u003c/code\u003e) that agents can use to reference the file in subsequent messages.\u003c/p\u003e\n"]]],[],null,["# Method: files.create\n\nUploads a file for use in media or rich card messages.\n\nThe agent provides the URL or binary of the file and (optionally) the URL of the corresponding thumbnail file.\n\nImportant: For user privacy and security, the RBM platform downloads and processes media and PDF files from the provided URLs before delivering them to the user. This prevents agent tracking by unique URLs. Therefore, do not submit a high volume of unique URLs. The RBM platform does not support this, whether the URLs point to the same or different files. Use the same URL for identical files.\n\nThe RBM platform caches the file for 60 days and returns a unique name that you can use to identify the file when sending agent messages.\n\nTo upload a file binary, make an HTTP POST request to the Upload URI, omit the `fileUrl` field from the JSON request body, and specify the binary as the POST request body. For example, use the `--upload-file` cURL flag with the fully qualified file path of the binary file.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files`\n- Metadata URI, for metadata-only requests: \n `POST https://rcsbusinessmessaging.googleapis.com/v1/files`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------|\n| ``` { \"fileUrl\": string, \"thumbnailUrl\": string, \"agentId\": string } ``` |\n\n| Fields ||\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileUrl` | `string` Optional. Publicly available URL of the file. The RBM platform determines the MIME type of the file from the content-type field in the HTTP headers when fetching the file. RBM supports image, audio, video, and pdf. Supported image content types: image/jpeg, image/jpg, image/gif, image/png. Supported audio content types: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg. Supported video content types: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm. Supported pdf content types: application/pdf. Note: file URL can have 1 redirect. Redirected file URLs must be publicly accessible. Redirects are not supported for file URLs in CreateAgentMessageRequest. |\n| `thumbnailUrl` | `string` Optional. Publicly available URL of the thumbnail corresponding to the file. If this field is not set, then the RBM platform automatically generates a thumbnail from the file. The RBM platform determines the MIME type of the file from the content-type field in the HTTP headers when fetching the file. Supported image content types: image/jpeg, image/jpg, image/gif, image/png. |\n| `agentId` | `string` Required. The agent's unique identifier. |\n\n### Response body\n\nA file resource with a unique name that an agent can use to identify the file when sending messages.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------|\n| ``` { \"name\": string } ``` |\n\n| Fields ||\n|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Server-assigned unique name of the file resource, which an agent can use to identify the file when sending messages. The format is \"files/{uid}\", where {uid} is a unique ID. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/rcsbusinessmessaging`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
