People API

Profiller ve kişiler hakkındaki bilgilere erişim sağlar.

Hizmet: contacts.googleapis.com

Bu hizmeti çağırmak için Google tarafından sağlanan istemci kitaplıklarını kullanmanızı öneririz. Uygulamanızın bu hizmeti çağırmak için kendi kitaplıklarınızı kullanması gerekiyorsa API isteklerinde bulunurken aşağıdaki bilgileri kullanın.

Keşif dokümanı

Keşif Dokümanı, REST API'lerini açıklamak ve kullanmak için makine tarafından okunabilir bir spesifikasyondur. İstemci kitaplıkları, IDE eklentileri ve Google API'leri ile etkileşimde bulunan diğer araçları oluşturmak için kullanılır. Bir hizmet, birden fazla keşif dokümanı sağlayabilir. Bu hizmet, aşağıdaki keşif dokümanını sağlar:

Hizmet uç noktası

Hizmet uç noktası, bir API hizmetinin ağ adresini belirten bir temel URL'dir. Bir hizmetin birden fazla hizmet uç noktası olabilir. Bu hizmetin aşağıdaki hizmet uç noktası vardır ve aşağıdaki tüm URI'ler bu hizmet uç noktasına bağlıdır:

  • https://people.googleapis.com

REST Kaynağı: v1.contactGroups

Yöntemler
batchGet GET /v1/contactGroups:batchGet
Kişi grubu kaynak adlarının listesini belirterek, kimliği doğrulanmış kullanıcının sahip olduğu kişi gruplarının listesini alın.
create POST /v1/contactGroups
Kimliği doğrulanmış kullanıcıya ait yeni bir kişi grubu oluşturun.
delete DELETE /v1/{resourceName=contactGroups/*}
Kimliği belirlenmiş kullanıcının sahibi olduğu mevcut bir kişi grubunu, bir kişi grubu kaynak adı belirterek silin.
get GET /v1/{resourceName=contactGroups/*}
Bir kişi grubu kaynak adı belirterek, kimliği doğrulanmış kullanıcının sahip olduğu belirli bir kişi grubunu alın.
list GET /v1/contactGroups
Kimliği doğrulanmış kullanıcının sahip olduğu tüm kişi gruplarını listeleyin.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Kimliği doğrulanmış kullanıcının sahip olduğu mevcut kişi grubunun adını güncelleyin.

REST Kaynağı: v1.contactGroups.members

Yöntemler
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Kimliği doğrulanmış kullanıcının sahibi olduğu kişi grubunun üyelerini değiştirin.

REST Kaynağı: v1.otherContacts

Yöntemler
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

"Diğer Kişiler"i, kullanıcının "Kişilerim" grubundaki yeni bir kişiye kopyalar

Artan gecikme ve hatalardan kaçınmak için aynı kullanıcıya ait istek istekleri sırayla gönderilmelidir.
list GET /v1/otherContacts
Bir kişi grubunda olmayan tüm "Diğer kişiler"i listeleyin.
search GET /v1/otherContacts:search
Kimliği doğrulanmış kullanıcının arama sorgusuyla eşleşen diğer kişilerindeki kişilerin listesini sağlar.

REST Kaynağı: v1.people

Yöntemler
batchCreateContacts POST /v1/people:batchCreateContacts

Bir grup yeni kişi oluşturun ve yeni kişiler için PersonResponses'u döndürün

Artan gecikme ve hatalardan kaçınmak için aynı kullanıcıya ait istek istekleri sırayla gönderilmelidir.
batchDeleteContacts POST /v1/people:batchDeleteContacts
Bir kişi grubunu silin.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Bir grup kişiyi güncelleyin ve güncellenen kişiler için kaynak adlarının bir listesini PersonResponses'a döndürün.
createContact POST /v1/people:createContact
Yeni bir kişi oluşturun ve söz konusu kişinin kişi kaynağını döndürün.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Bir kişiyi silin.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Bir kişinin fotoğrafını silin.
get GET /v1/{resourceName=people/*}
Kaynak adı belirterek bir kişi hakkında bilgi sağlar.
getBatchGet GET /v1/people:batchGet
İstenen kaynak adlarının listesini belirterek belirli kişilerin listesi hakkında bilgi sağlar.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Kimliği doğrulanmış kullanıcının alan dizininde, alan profillerinin ve alan kişilerinin listesini sağlar.
searchContacts GET /v1/people:searchContacts
Kimliği doğrulanmış kullanıcının gruplanmış kişilerinde, arama sorgusuyla eşleşen kişilerin listesini sağlar.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Kimliği doğrulanmış kullanıcının alan dizininde, arama sorgusuyla eşleşen alan profillerinin ve alan kişilerinin bir listesini sağlar.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Mevcut bir kişi kişisinin iletişim verilerini güncelleyin.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Bir kişinin fotoğrafını güncelleyin.

REST Kaynağı: v1.people.connections

Yöntemler
list GET /v1/{resourceName=people/*}/connections
Kimliği doğrulanmış kullanıcının kişilerinin listesini sağlar.