Contacts

Để biết danh sách phương thức cho tài nguyên này, hãy xem phần cuối của trang này.

Biểu diễn tài nguyên

Một người hoặc nhóm có thể được sử dụng làm người sáng tạo hoặc người liên hệ.

{
  "kind": "mirror#contact",
  "source": string,
  "id": string,
  "displayName": string,
  "imageUrls": [
    string
  ],
  "type": string,
  "acceptTypes": [
    string
  ],
  "phoneNumber": string,
  "priority": unsigned integer,
  "acceptCommands": [
    {
      "type": string
    }
  ],
  "speakableName": string,
  "sharingFeatures": [
    string
  ]
}
Tên tài sản Giá trị Mô tả Ghi chú
acceptCommands[] list Danh sách các lệnh trong trình đơn thoại mà một người liên hệ có thể xử lý. Glass hiển thị tối đa ba địa chỉ liên hệ cho mỗi lệnh trong trình đơn thoại. Nếu có nhiều hơn thế, ba địa chỉ liên hệ có priority cao nhất được hiển thị cho lệnh cụ thể đó. có thể ghi
acceptCommands[].type string Loại thao tác tương ứng với lệnh này. Các giá trị được cho phép là:
  • TAKE_A_NOTE – Chia sẻ mục dòng thời gian với bản chép lời thoại của người dùng từ lệnh trong trình đơn "Ghi chú".
  • POST_AN_UPDATE – Chia sẻ mục dòng thời gian với bản chép lời thoại của người dùng từ lệnh trong trình đơn "Đăng nội dung cập nhật".
có thể ghi
acceptTypes[] list Danh sách các loại MIME mà một người liên hệ hỗ trợ. Địa chỉ liên hệ sẽ hiển thị với người dùng nếu bất kỳ hình thức chấp nhận nào phù hợp với bất kỳ loại tệp đính kèm nào trên mục đó. Nếu bạn không đưa ra chấp nhận, loại liên hệ sẽ hiển thị cho tất cả các mục. có thể ghi
displayName string Tên hiển thị cho người liên hệ này. có thể ghi
id string Mã nhận dạng cho địa chỉ liên hệ này. Mã này do ứng dụng tạo ra và được coi là một mã thông báo mờ. có thể ghi
imageUrls[] list Tập hợp URL hình ảnh để hiển thị cho một người liên hệ. Hầu hết địa chỉ liên hệ sẽ có một hình ảnh, nhưng địa chỉ liên hệ "nhóm" có thể bao gồm tối đa 8 URL hình ảnh và chúng sẽ được đổi kích thước và cắt thành tranh khảm trên ứng dụng khách. có thể ghi
kind string Loại tài nguyên. Đây luôn là mirror#contact.
phoneNumber string Số điện thoại chính của người liên hệ. Đây có thể là một số đủ điều kiện, có mã gọi quốc gia và mã vùng hoặc một số địa phương. có thể ghi
priority unsigned integer Mức độ ưu tiên cho người liên hệ để xác định thứ tự trong danh sách người liên hệ. Những người liên hệ có mức độ ưu tiên cao hơn sẽ hiển thị trước người liên hệ có mức độ ưu tiên thấp hơn. có thể ghi
sharingFeatures[] list Danh sách các tính năng chia sẻ mà một người liên hệ có thể xử lý. Các giá trị được cho phép là:
  • ADD_CAPTION
source string Mã của ứng dụng đã tạo liên hệ này. API này được điền sẵn
speakableName string Tên của người liên hệ này phải được phát âm. Nếu tên của người liên hệ này phải được đọc trong trình đơn phân định giọng nói, thì tên này sẽ được dùng làm cách phát âm dự kiến. Điều này rất hữu ích cho những tên người liên hệ có các ký tự không được phát âm hoặc có cách viết chính tả khác với phiên âm. có thể ghi
type string Loại liên hệ. Giá trị này được dùng để sắp xếp trong giao diện người dùng. Các giá trị được cho phép là:
  • INDIVIDUAL – Đại diện cho một người. Đây là tuỳ chọn mặc định.
  • GROUP – Đại diện cho nhiều người.
có thể ghi

Phương pháp

xóa
Xoá người liên hệ.
tải
Nhận một người liên hệ theo mã nhận dạng.
chèn
Chèn một người liên hệ mới.
list
Truy xuất danh sách liên hệ cho người dùng đã xác thực.
bản vá
Cập nhật địa chỉ liên hệ. Phương thức này hỗ trợ ngữ nghĩa bản vá.
cập nhật
Cập nhật địa chỉ liên hệ.