Method: phones.getCapabilities

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

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

การจัดการข้อผิดพลาด: ระบบจะแสดงข้อผิดพลาด 404 NOT_FOUND เมื่อเข้าถึงผู้ใช้ด้วย RBM ไม่ได้ ซึ่งรวมถึงสถานการณ์ต่างๆ ดังนี้ (1) อุปกรณ์ของผู้ใช้ไม่รองรับ RCS หรือปิดใช้ RCS (2) ผู้ใช้ใช้เครือข่ายมือถือที่ไม่ได้เปิดตัวเอเจนต์หรือไม่ได้เปิดใช้การเข้าชม RCS (3) เอเจนต์ที่ยังไม่ได้เปิดตัวขอความสามารถของผู้ใช้ที่ไม่ได้เป็นผู้ทดสอบ

คำขอ 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 Overview

ฟีเจอร์

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

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