Contacts

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

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

Một người hoặc nhóm có thể dùng làm người 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ý. Ứng dụng Glass hiển thị tối đa 3 địa chỉ liên hệ cho mỗi lệnh trên trình đơn bằng giọng nói. Nếu nhiều hơn giá trị đó, 3 địa chỉ liên hệ có priority cao nhất sẽ 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 phép là:
  • TAKE_A_NOTE – Chia sẻ một mục trong dòng thời gian với bản chép lời lời nói của người dùng trong ứng dụng "Tạo ghi chú" lệnh trên trình đơn giọng nói.
  • POST_AN_UPDATE – Chia sẻ một mục trong dòng thời gian kèm theo bản chép lời lời nói của người dùng trong mục "Đăng bản cập nhật" lệnh trên trình đơn giọng nói.
có thể ghi
acceptTypes[] list Danh sách các loại MIME mà một người liên hệ hỗ trợ. Thông tin liên hệ này sẽ được hiển thị với người dùng nếu có bất kỳ giá chấp nhận nào khớp với bất kỳ loại tệp đính kèm nào trên mục. Nếu không có mạng AcceptTypes nào, địa chỉ liên hệ này 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 người liên hệ này. Mã này do ứng dụng tạo ra và được coi là 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 duy nhất, nhưng có một "nhóm" người liên hệ có thể bao gồm tối đa 8 URL hình ảnh. Các URL này sẽ được đổi kích thước và cắt thành một tranh mosaic trên máy khách. có thể ghi
kind string Loại tài nguyên. Thao tác 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à số điện thoại đủ điều kiện, có mã gọi quốc gia và mã vùng hoặc một số điện thoại tại đị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ệ. 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à người liên hệ có thể sử dụng. Các giá trị được phép là:
  • ADD_CAPTION
source string Mã ứng dụng đã tạo địa chỉ liên hệ này. Thông tin này được điền bởi API
speakableName string Tên của người liên hệ này (phải được phát âm). Nếu phải đọc tên của người liên hệ này 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 phát âm được hoặc những tên có cách viết hiển thị không đúng phiên âm. có thể ghi
type string Loại cho người liên hệ này. Quy tắc này được dùng để sắp xếp trong giao diện người dùng. Các giá trị được phép là:
  • INDIVIDUAL – Đại diện cho một người duy nhất. Đây là tuỳ chọn mặc định.
  • GROUP – Đại diện cho nhiều người.
có thể ghi

Phương thức

xóa
Xoá một người liên hệ.
nhận
Lấy 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 thông tin liên hệ của người dùng đã được xác thực.
bản vá
Cập nhật một người liên hệ tại chỗ. Phương thức này hỗ trợ ngữ nghĩa của bản vá.
cập nhật
Cập nhật một người liên hệ tại chỗ.