Method: files.create

Mengupload file untuk digunakan dalam pesan media atau kartu multimedia.

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

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

Platform RCS for Business menyimpan file dalam cache selama 60 hari dan menampilkan nama unik yang dapat Anda gunakan untuk mengidentifikasi file saat mengirim pesan agen.

Untuk mengupload biner file, buat permintaan HTTP POST ke URI Upload, hapus kolom fileUrl dari isi permintaan JSON, dan tentukan biner sebagai isi permintaan POST. Misalnya, gunakan tanda 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 ini 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 RCS untuk Bisnis menentukan jenis MIME file dari kolom content-type di header HTTP saat mengambil file. RCS untuk Bisnis 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 satu 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 yang sesuai dengan file. Jika kolom ini tidak disetel, platform RCS untuk Bisnis akan otomatis membuat thumbnail dari file. Platform RCS untuk Bisnis 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 yang ditetapkan server untuk resource file 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.