Google Contacts Routing Reference

Google Contacts Routing Reference

Название приложения: google-contacts
Базовый URL (проксируемый): people.googleapis.com

Шаблон API-пути

/google-contacts/v1/{endpoint}

Основные эндпоинты

Список контактов

GET /google-contacts/v1/people/me/connections?personFields=names,emailAddresses,phoneNumbers&pageSize=100

Получить контакт

GET /google-contacts/v1/people/{resourceName}?personFields=names,emailAddresses,phoneNumbers

Пример: GET /google-contacts/v1/people/c1234567890?personFields=names,emailAddresses

Создать контакт

POST /google-contacts/v1/people:createContact
Content-Type: application/json

{
 "names": [{"givenName": "John", "familyName": "Doe"}],
 "emailAddresses": [{"value": "john@example.com"}],
 "phoneNumbers": [{"value": "+1-555-0123"}]
}

Обновить контакт

PATCH /google-contacts/v1/people/{resourceName}:updateContact?updatePersonFields=names,emailAddresses
Content-Type: application/json

{
 "etag": "%EgcBAgkLLjc9...",
 "names": [{"givenName": "John", "familyName": "Smith"}]
}

Удалить контакт

DELETE /google-contacts/v1/people/{resourceName}:deleteContact

Массовое получение контактов

GET /google-contacts/v1/people:batchGet?resourceNames=people/c123&resourceNames=people/c456&personFields=names

Массовое создание контактов

POST /google-contacts/v1/people:batchCreateContacts
Content-Type: application/json

{
 "contacts": [{"contactPerson": {"names": [{"givenName": "Alice"}]}}],
 "readMask": "names"
}

Массовое удаление контактов

POST /google-contacts/v1/people:batchDeleteContacts
Content-Type: application/json

{
 "resourceNames": ["people/c123", "people/c456"]
}

Поиск контактов

GET /google-contacts/v1/people:searchContacts?query=John&readMask=names,emailAddresses

Список групп контактов

GET /google-contacts/v1/contactGroups?pageSize=100

Получить группу контактов

GET /google-contacts/v1/contactGroups/{resourceName}?maxMembers=100

Создать группу контактов

POST /google-contacts/v1/contactGroups
Content-Type: application/json

{
 "contactGroup": {"name": "Work Contacts"}
}

Удалить группу контактов

DELETE /google-contacts/v1/contactGroups/{resourceName}?deleteContacts=false

Изменение участников группы

POST /google-contacts/v1/contactGroups/{resourceName}/members:modify
Content-Type: application/json

{
 "resourceNamesToAdd": ["people/c123"],
 "resourceNamesToRemove": ["people/c456"]
}

Список прочих контактов

GET /google-contacts/v1/otherContacts?readMask=names,emailAddresses&pageSize=100

Примечания

• Идентификаторы контактов имеют формат: people/c{id} (например, people/c1234567890)
• Идентификаторы групп: contactGroups/{id} (например, contactGroups/starred)
• Системные группы: starred, friends, family, coworkers, myContacts, all, blocked
• Параметр personFields обязателен для большинства операций чтения
• Используйте etag при обновлении, чтобы избежать конфликтов параллельных изменений
• Пагинация осуществляется через параметр pageToken

Ресурсы

• Обзор Google People API
• Ресурс Person
• Ресурс Contact Groups