Method: files.create

Mengupload file untuk digunakan dalam pesan media atau kartu informasi.

Agen memberikan URL atau biner file dan (opsional) URL file thumbnail yang sesuai.

Penting: Untuk privasi dan keamanan pengguna, platform RBM mendownload dan memproses file media dan PDF dari URL yang diberikan sebelum mengirimkannya kepada pengguna. Hal ini mencegah pelacakan agen berdasarkan URL unik. Oleh karena itu, jangan mengirimkan URL unik dalam jumlah besar. Platform RBM tidak mendukung hal ini, baik URL mengarah ke file yang sama maupun berbeda. Gunakan URL yang sama untuk file yang identik.

Platform RBM meng-cache file selama 60 hari dan menampilkan nama unik yang dapat Anda gunakan untuk mengidentifikasi file saat mengirim pesan agen.

Untuk mengupload file biner, buat permintaan POST HTTP ke URI Upload, hapus kolom fileUrl dari isi permintaan JSON, dan tentukan biner sebagai isi permintaan POST. Misalnya, gunakan flag cURL --upload-file dengan jalur file yang sepenuhnya memenuhi syarat dari file biner.

Permintaan HTTP

  • URI upload, untuk permintaan upload media:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI metadata, khusus untuk permintaan metadata:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
Kolom
fileUrl

string

Opsional. URL file yang tersedia secara publik. Platform RBM menentukan jenis MIME file dari kolom content-type di header HTTP saat mengambil file. RBM mendukung gambar, audio, video, dan pdf.

Jenis konten gambar yang didukung: image/jpeg, image/jpg, image/gif, image/png.

Jenis konten audio yang didukung: audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg.

Jenis konten video yang didukung: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm.

Jenis konten PDF yang didukung: application/pdf.

Catatan: URL file dapat memiliki 1 pengalihan. URL file yang dialihkan harus dapat diakses secara publik. Pengalihan tidak didukung untuk URL file di CreateAgentMessageRequest.
thumbnailUrl

string

Opsional. URL thumbnail yang tersedia secara publik dan sesuai dengan file. Jika kolom ini tidak ditetapkan, platform RBM akan otomatis membuat thumbnail dari file. Platform RBM menentukan jenis MIME file dari kolom content-type di header HTTP saat mengambil file.

Jenis konten gambar yang didukung: image/jpeg, image/jpg, image/gif, image/png.
agentId

string

Wajib. ID unik agen.

Isi respons

Resource file dengan nama unik yang dapat digunakan agen untuk mengidentifikasi file saat mengirim pesan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Nama unik resource file yang ditetapkan server, yang dapat digunakan agen untuk mengidentifikasi file saat mengirim pesan. Formatnya adalah "files/{uid}", dengan {uid} adalah ID unik.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.