Method: files.create

อัปโหลดไฟล์เพื่อใช้ในข้อความสื่อหรือริชการ์ด

โดยตัวแทนจะระบุ URL หรือไบนารีของไฟล์และ (ไม่บังคับ) URL ของไฟล์ภาพปกที่เกี่ยวข้อง

สำคัญ: แพลตฟอร์ม RBM จะดาวน์โหลดและประมวลผลไฟล์สื่อและไฟล์ PDF จาก URL ที่ระบุไว้ก่อนที่จะส่งให้ผู้ใช้ เพื่อรักษาความเป็นส่วนตัวและความปลอดภัยของผู้ใช้ วิธีนี้จะช่วยป้องกันไม่ให้ระบบติดตามตัวแทนตาม URL ที่ไม่ซ้ำกัน ดังนั้นโปรดอย่าส่ง URL ที่ไม่ซ้ำกันจํานวนมาก เนื่องจากแพลตฟอร์ม RBM ไม่รองรับการดำเนินการนี้ ไม่ว่า URL จะชี้ไปยังไฟล์เดียวกันหรือไฟล์อื่น ใช้ URL เดียวกันสำหรับไฟล์ที่เหมือนกัน

แพลตฟอร์ม RBM จะแคชไฟล์ไว้ 60 วันและแสดงผลชื่อที่ไม่ซ้ำกันซึ่งคุณใช้ระบุไฟล์เมื่อส่งข้อความของตัวแทนได้

หากต้องการอัปโหลดไฟล์ไบนารี ให้ส่งคำขอ HTTP POST ไปยัง URI การอัปโหลด ละเว้นช่อง fileUrl จากเนื้อหาคำขอ JSON และระบุไบนารีเป็นเนื้อหาคำขอ POST เช่น ใช้ Flag --upload-file cURL กับเส้นทางไฟล์ที่มีคุณสมบัติครบถ้วนของไฟล์ไบนารี

คำขอ HTTP

  • URI การอัปโหลดสำหรับคำขออัปโหลดสื่อ:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • URI ของข้อมูลเมตาสำหรับคำขอข้อมูลเมตาเท่านั้น
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
ช่อง
fileUrl

string

ไม่บังคับ URL ของไฟล์ที่เผยแพร่ต่อสาธารณะ แพลตฟอร์ม RBM จะกำหนดประเภท MIME ของไฟล์จากช่องประเภทเนื้อหาในส่วนหัว HTTP เมื่อดึงข้อมูลไฟล์ RBM รองรับรูปภาพ เสียง วิดีโอ และ PDF

ประเภทเนื้อหารูปภาพที่รองรับ ได้แก่ image/jpeg, image/jpg, image/gif, image/png

ประเภทเนื้อหาเสียงที่รองรับ ได้แก่ audio/aac, audio/mp3, audio/mpeg, audio/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg

ประเภทเนื้อหาวิดีโอที่รองรับ ได้แก่ video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm

ประเภทเนื้อหา PDF ที่รองรับ: application/pdf
thumbnailUrl

string

ไม่บังคับ URL สาธารณะของภาพปกที่สอดคล้องกับไฟล์ หากไม่ได้ตั้งค่าช่องนี้ แพลตฟอร์ม RBM จะสร้างภาพปกจากไฟล์โดยอัตโนมัติ แพลตฟอร์ม RBM จะกำหนดประเภท MIME ของไฟล์จากช่องประเภทเนื้อหาในส่วนหัว HTTP เมื่อดึงข้อมูลไฟล์

ประเภทเนื้อหารูปภาพที่รองรับ ได้แก่ image/jpeg, image/jpg, image/gif, image/png
agentId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของตัวแทน

เนื้อหาการตอบกลับ

ทรัพยากรไฟล์ที่มีชื่อที่ไม่ซ้ำกันซึ่งตัวแทนสามารถใช้เพื่อระบุไฟล์เมื่อส่งข้อความ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "name": string
}
ช่อง
name

string

ชื่อที่ไม่ซ้ำกันซึ่งเซิร์ฟเวอร์กำหนดให้กับทรัพยากรไฟล์ ซึ่งตัวแทนสามารถใช้เพื่อระบุไฟล์เมื่อส่งข้อความ รูปแบบคือ "files/{uid}" โดยที่ {uid} คือรหัสที่ไม่ซ้ำกัน

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview