People API

Profiller ve kişilerle ilgili bilgilere erişim sağlar.

Hizmet: people.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 isteği gönderirken aşağıdaki bilgileri kullanın.

Keşif dokümanı

Keşif Belgesi, REST API'lerini tanımlamaya ve kullanmaya yönelik, makine tarafından okunabilir bir spesifikasyondur. İstemci kitaplıkları, IDE eklentileri ve Google API'leriyle etkileşimde bulunan başka 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 temel URL'dir. Bir hizmet, birden fazla hizmet uç noktasına sahip olabilir. Bu hizmet, aşağıdaki hizmet uç noktasına sahiptir ve aşağıdaki tüm URI'ler bu hizmet uç noktasıyla ilişkilidir:

  • https://people.googleapis.com

REST Kaynağı: v1.contactGroups

Yöntemler
batchGet GET /v1/contactGroups:batchGet
Kişi grubu kaynak adlarının bir 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/*}
Kişi grubu kaynak adı belirterek, kimliği doğrulanmış kullanıcıya ait mevcut bir kişi grubunu silin.
get GET /v1/{resourceName=contactGroups/*}
Kişi grubu kaynak adı belirterek, kimliği doğrulanmış kullanıcıya ait 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ı listeler.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Kimliği doğrulanmış kullanıcıya ait mevcut bir 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ıya ait bir kişi grubunun üyelerini değiştirin.

REST Kaynağı: v1.otherContacts

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

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

Aynı kullanıcıya yönelik değişiklik istekleri, daha fazla gecikme ve hata oluşmasını önlemek için sırayla gönderilmelidir.

list GET /v1/otherContacts
"Diğer kişiler"in, yani bir kişi grubunda yer almayan tüm kişileri listeleyin.
search GET /v1/otherContacts:search
Kimliği doğrulanan kullanıcının diğer kişilerinde, arama sorgusuyla eşleşen kişilerin bir listesini sağlar.

REST Kaynağı: v1.people

Yöntemler
batchCreateContacts POST /v1/people:batchCreateContacts

Yeni kişiler grubu oluşturun ve yeni kişiler için PersonResponses

Aynı kullanıcıya yönelik değişiklik istekleri, daha fazla gecikme ve hata oluşmasını önlemek için sırayla gönderilmelidir.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Kişileri toplu olarak silin.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Bir kişi grubunu güncelleyin ve güncellenen kişiler için PersonResponses'a kaynak adları haritasını döndürün.
createContact POST /v1/people:createContact
Yeni bir kişi oluşturun ve bu kişi için kişi kaynağını döndürün.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
İlgili kişiyi silin.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Bir kişinin fotoğrafını silin.
get GET /v1/{resourceName=people/*}
Kaynak adı belirterek 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 dizinindeki alan profillerinin ve alan kişilerinin listesini sağlar.
searchContacts GET /v1/people:searchContacts
Kimliği doğrulanmış kullanıcının gruplandırılmış kişilerinde, arama sorgusuyla eşleşen kişilerin bir 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 listesini sağlar.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Mevcut bir ilgili kişinin kişi 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ğrulanan kullanıcının kişilerinin bir listesini sağlar.