Method: files.create

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

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

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

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

หากต้องการอัปโหลดไบนารีของไฟล์ ให้ส่งคำขอ HTTP POST ไปยัง URI การอัปโหลด ละเว้นฟิลด์ fileUrl จากเนื้อหาคำขอ JSON และระบุไบนารีเป็นเนื้อหาคำขอ POST เช่น ใช้--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 ของไฟล์ที่เผยแพร่ต่อสาธารณะ แพลตฟอร์ม RCS สำหรับธุรกิจจะกำหนดประเภท MIME ของไฟล์จากฟิลด์ประเภทเนื้อหาในส่วนหัว HTTP เมื่อดึงข้อมูลไฟล์ RCS สำหรับธุรกิจรองรับรูปภาพ เสียง วิดีโอ และ 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

หมายเหตุ: URL ของไฟล์มีการเปลี่ยนเส้นทางได้ 1 รายการ URL ของไฟล์ที่เปลี่ยนเส้นทางต้องเข้าถึงได้แบบสาธารณะ URL ของไฟล์ใน CreateAgentMessageRequest ไม่รองรับการเปลี่ยนเส้นทาง
thumbnailUrl

string

ไม่บังคับ URL ที่เผยแพร่ต่อสาธารณะของภาพปกที่สอดคล้องกับไฟล์ หากไม่ได้ตั้งค่าช่องนี้ แพลตฟอร์ม RCS สำหรับธุรกิจจะสร้างภาพปกจากไฟล์โดยอัตโนมัติ แพลตฟอร์ม RCS สำหรับธุรกิจจะกำหนดประเภท 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