Method: phones.getCapabilities

รับความสามารถที่เกี่ยวข้องกับ RBM ของผู้ใช้

เพย์โหลดที่ส่งคืนจะระบุว่าผู้ใช้สามารถเข้าถึงผู้ใช้ด้วย RBM ได้หรือไม่ และหากเข้าถึง จะแสดงคุณลักษณะใดของ RBM ที่ผู้ใช้รองรับ หากไม่สามารถเข้าถึงผู้ใช้ด้วย RBM แพลตฟอร์ม RBM จะส่งคืน 404 NOT_FOUND

Agent ที่ไม่ได้เปิดใช้งานจะขอความสามารถของได้เฉพาะผู้ใช้ที่เป็นผู้ทดสอบของ Agent นั้นเท่านั้น หากตัวแทนที่ยังไม่ได้เปิดใช้งานขอความสามารถของผู้ที่ไม่ใช่ผู้ทดสอบ แพลตฟอร์ม RBM จะแสดงผล 403 PERMISSION_DENIED

คำขอ HTTP

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

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

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ช่องนี้แปลงค่าเป็น "phones/{E.164}/capabilities" โดยที่ {E.164} คือหมายเลขโทรศัพท์ของผู้ใช้ในรูปแบบ E.164 ตัวอย่างเช่น สำหรับผู้ใช้ที่มีหมายเลขโทรศัพท์ในสหรัฐอเมริกา +1-222-333-4444 ปลายทางที่ได้คือ https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities

พารามิเตอร์การค้นหา

พารามิเตอร์
requestId

string

รหัสที่ไม่ซ้ำกันของคำขอ ซึ่งกำหนดโดยตัวแทน ซึ่งต้องเป็น UUID ตามที่กําหนดไว้ใน https://tools.ietf.org/html/rfc4122 หากรหัสคำขอตรงกับรหัสที่ตัวแทนใช้สำหรับคำขอก่อนหน้า แพลตฟอร์ม RBM จะไม่สนใจคำขอใหม่
agentId

string

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

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

เนื้อหาของคำขอต้องว่างเปล่า

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

รายการฟีเจอร์ที่ผู้ใช้รองรับ

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

การแสดง JSON 
{
  "features": [
    enum (Feature)
  ]
}
ช่อง
features[]

enum (Feature)

รายการฟีเจอร์ RBM ที่อุปกรณ์นี้รองรับ

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

ฟีเจอร์

ประเภทของฟีเจอร์ RBM ที่ผู้ใช้รองรับ

Enum
FEATURE_UNSPECIFIED ไม่ได้ระบุ
REVOCATION การเพิกถอน หากผู้ใช้รองรับการเพิกถอน ตัวแทนสามารถเพิกถอนข้อความที่ส่งก่อนที่แพลตฟอร์ม RBM จะส่งข้อความได้
RICHCARD_STANDALONE การ์ดริชมีเดียแบบสแตนด์อโลน
ACTION_CREATE_CALENDAR_EVENT การดำเนินการที่แนะนำเพื่อสร้างกิจกรรมในปฏิทิน
ACTION_DIAL การดำเนินการที่แนะนำเพื่อกดหมายเลข
ACTION_OPEN_URL การดำเนินการที่แนะนำเพื่อเปิด URL
ACTION_SHARE_LOCATION การดำเนินการที่แนะนำในการแชร์ตำแหน่ง
ACTION_VIEW_LOCATION การดำเนินการที่แนะนำเพื่อดูตำแหน่งในแอปแผนที่