संपर्कों को पढ़ें और मैनेज करें

People API का इस्तेमाल करने के लिए तैयार रहें में दिए गए चरणों को पूरा करने के बाद, संपर्कों को पढ़ने और मैनेज करने के लिए तैयार किया जा सकता है.

नीचे दिए गए कोड सैंपल बताते हैं कि कुछ आसान अनुरोध कैसे भेजे जाते हैं. तरीकों की पूरी सूची के लिए, रेफ़रंस दस्तावेज़ देखें.

उपयोगकर्ता के संपर्कों की सूची बनाएं

उपयोगकर्ता के संपर्क में मौजूद लोगों की सूची पाने के लिए, इस कोड का इस्तेमाल करें:

प्रोटोकॉल

GET /v1/people/me/connections?personFields=names,emailAddresses HTTP/1.1
Host: people.googleapis.com

Java

ListConnectionsResponse response = peopleService.people().connections().list("people/me")
    .setPersonFields("names,emailAddresses")
    .execute();
List<Person> people = response.getConnections();

Python

people = people_service.people().connections()
    .list('people/me', personFields='names,emailAddresses')

PHP

$people = $people_service->people_connections->listPeopleConnections(
    'people/me', array('personFields' => 'names,emailAddresses'));

.NET

PeopleResource.ConnectionsResource.ListRequest peopleRequest =
    peopleService.People.Connections.List("people/me");
peopleRequest.PersonFields = "names,emailAddresses";
ListConnectionsResponse response = peopleRequest.Execute();
IList<Person> people = response.Connections;

उपयोगकर्ता के उन संपर्कों की सूची बनाएं जिनमें बदलाव किया गया है

Java

// Initial request
ListConnectionsResponse fullSyncResponse = peopleService.people().connections().list("people/me")
    .setPersonFields("metadata,names,emailAddresses")
    .setRequestSyncToken(true)
    .execute();
// Fetch all the pages
while (fullSyncResponse.getNextPageToken() != null) {
  fullSyncResponse = peopleService.people().connections().list("people/me")
      .setPersonFields("metadata,names,emailAddresses")
      .setRequestSyncToken(true)
      .setPageToken(fullSyncResponse.getNextPageToken())
      .execute();
}

// Some time passes

// Fetch incremental changes using the sync token returned in the last fullSyncResponse.
try {
  ListConnectionsResponse incrementalSyncResponse = peopleService.people().connections().list("people/me")
      .setPersonFields("metadata,names,emailAddresses")
      .setSyncToken(fullSyncResponse.getNextSyncToken())
      .execute();
  for (Person person : incrementalSyncResponse.getConnections()) {
    handlePerson(person);
  }

  // Fetch all the pages
  while (incrementalSyncResponse.getNextPageToken() != null) {
    incrementalSyncResponse = peopleService.people().connections().list("people/me")
        .setPersonFields("metadata,names,emailAddresses")
        .setSyncToken(fullSyncResponse.getNextSyncToken())
        .setPageToken(incrementalSyncResponse.getNextPageToken())
        .execute();
    for (Person person : incrementalSyncResponse.getConnections()) {
      handlePerson(person);
    }
  }
} catch (GoogleJsonResponseException e) {
  if (e.getStatusCode() == 410) {
    // Sync token expired. Make full sync request.
  }
}

void handlePerson(Person person) {
  if (person.getMetadata().getDeleted()) {
    // Handle deleted person
  } else {
    // Handle changed person
  }
}

सिंक व्यवहार के बारे में ज़्यादा जानकारी के लिए, ListConnections पर जाएं.

उपयोगकर्ता के संपर्क खोजना

उपयोगकर्ता के सभी संपर्क खोजने के लिए, नीचे दिए गए कोड का इस्तेमाल करें:

प्रोटोकॉल

// Warmup cache
GET /v1/people:searchContacts?query=&readMask=names,emailAddresses HTTP/1.1
Host: people.googleapis.com



// Send search request after several seconds
GET /v1/people:searchContacts?query=query&readMask=names,emailAddresses HTTP/1.1
Host: people.googleapis.com

Java

// Warmup cache
SearchResponse response = peopleService.people().searchContacts()
    .setQuery("")
    .setReadMask("names,emailAddresses")
    .execute();



// Wait a few seconds
Thread.sleep(5);



// Send search request
SearchResponse response = peopleService.people().searchContacts()
    .setQuery("query")
    .setReadMask("names,emailAddresses")
    .execute();

नया संपर्क बनाएं

नया संपर्क बनाने के लिए, नीचे दिए गए कोड का इस्तेमाल करें:

प्रोटोकॉल

POST /v1/people:createContact HTTP/1.1
Body: { "names": [{ "givenName": "John", "familyName": "Doe" }] }
Host: people.googleapis.com

Java

Person contactToCreate = new Person();
List<Name> names = new ArrayList<>();
names.add(new Name().setGivenName("John").setFamilyName("Doe"));
contactToCreate.setNames(names);

Person createdContact = peopleService.people().createContact(contactToCreate).execute();

हर अनुरोध के लिए कोटा का इस्तेमाल

  • पढ़ने के 1 ज़रूरी अनुरोध (संपर्क और प्रोफ़ाइल को पढ़ना)
  • 1 महत्वपूर्ण लिखने के अनुरोध (संपर्क बनाए और अपडेट)
  • रोज़ाना 1 बार संपर्क में आने वाले लोगों की संख्या (कुल)

किसी मौजूदा संपर्क को अपडेट करें

किसी मौजूदा संपर्क को अपडेट करने के लिए, आपको उस संपर्क की जानकारी में person.metadata.sources.etag फ़ील्ड शामिल करना होगा, ताकि यह पक्का किया जा सके कि पिछली बार पढ़े जाने के बाद संपर्क में कोई बदलाव नहीं हुआ है. इस कोड का इस्तेमाल करें:

प्रोटोकॉल

PATCH /v1/resource_name:updateContact?updatePersonFields=emailAddresses HTTP/1.1
Body: {
    "resourceName": "resource_name",
    "etag": "etag",
    "emailAddresses": [{ "value": "john.doe@gmail.com" }],
}
Host: people.googleapis.com

Java

Person contactToUpdate = peopleService.people().get("resource_name").execute();

List<EmailAddress> emailAddresses = new ArrayList<>();
emailAddresses.add(new EmailAddress().setValue("john.doe@gmail.com"));
contactToUpdate.setEmailAddresses(emailAddresses);

Person updatedContact = peopleService.people()
    .updateContact(contactToUpdate.getResourceName(), contactToUpdate)
    .setUpdatePersonFields("emailAddresses")
    .execute();

हर अनुरोध के लिए कोटा का इस्तेमाल

  • पढ़ने के 1 ज़रूरी अनुरोध (संपर्क और प्रोफ़ाइल को पढ़ना)
  • 1 महत्वपूर्ण लिखने के अनुरोध (संपर्क बनाए और अपडेट)
  • रोज़ाना 1 बार संपर्क में आने वाले लोगों की संख्या (कुल)

किसी मौजूदा संपर्क को मिटाना

किसी मौजूदा संपर्क को मिटाने के लिए, इस कोड का इस्तेमाल करें:

प्रोटोकॉल

DELETE /v1/resource_name:deleteContact HTTP/1.1
Host: people.googleapis.com

Java

peopleService.people().deleteContact("resource_name").execute();

हर अनुरोध के लिए कोटा का इस्तेमाल

  • 1 अनुरोध लिखें (संपर्कों को मिटाने और संपर्क ग्रुप को लिखने के लिए)

बैच में नए संपर्क बनाएं

नए संपर्क बनाने के लिए बैच बनाने के लिए, इस कोड का इस्तेमाल करें:

प्रोटोकॉल

POST /v1/people:batchCreateContacts?readMask=names HTTP/1.1
Body: {
  "contacts": [
    {
      "contactPerson": {
        "names": [
          {
            "givenName": "John",
            "familyName": "Doe"
          }
        ]
      }
    }
  ]
}
Host: people.googleapis.com

Java

Person person1 = new Person();
person1.setNames(ImmutableList.of(new Name().setGivenName("John").setFamilyName("Doe")));
ContactToCreate contactToCreate1 = new ContactToCreate();
contactToCreate1.setContactPerson(person1);

Person person2 = new Person();
person2.setNames(ImmutableList.of(new Name().setGivenName("Bob").setFamilyName("Dylan")));
ContactToCreate contactToCreate2 = new ContactToCreate();
contactToCreate2.setContactPerson(person2);

BatchCreateContactsRequest request = new BatchCreateContactsRequest();
request.setContacts(ImmutableList.of(contactToCreate1, contactToCreate2)).setReadMask("names");

BatchCreateContactsResponse response =
    peopleService.people().batchCreateContacts(request).execute();

हर अनुरोध के लिए कोटा का इस्तेमाल

  • पढ़े जाने के 6 ज़रूरी अनुरोध (संपर्क और प्रोफ़ाइल को पढ़ना)
  • 6 महत्वपूर्ण लिखने के अनुरोध (संपर्क बनाए और अपडेट)
  • हर दिन संपर्क के लिए 200 बार लिखे गए (कुल)

मौजूदा संपर्कों को बैच में अपडेट करें

किसी मौजूदा संपर्क को अपडेट करने के लिए, आपको हर व्यक्ति में person.metadata.sources.etag फ़ील्ड शामिल करना होगा, ताकि संपर्क को अपडेट किया जा सके. इससे यह पक्का किया जा सकेगा कि पिछली बार पढ़े जाने के बाद संपर्क में कोई बदलाव नहीं हुआ है. इस कोड का इस्तेमाल करें:

प्रोटोकॉल

POST /v1/people:batchUpdateContacts?updateMask=names&readMask=names,emailAddresses HTTP/1.1
Body: {
  "contacts": {
    "resource_name": {
      "emailAddresses": [
        {
          "value": "john.doe@gmail.com"
        }
      ]
      "etag": "etag"
    }
  }
}
Host: people.googleapis.com

Java

Person contactToUpdate = peopleService.people().get("resource_name").execute();

contactToUpdate.setNames(
    ImmutableList.of(new Name().setGivenName("John").setFamilyName("Doe")));

BatchUpdateContactsRequest request = new BatchUpdateContactsRequest();
ImmutableMap<String, Person> map =
    ImmutableMap.of(contactToUpdate.getResourceName(), contactToUpdate);
request.setContacts(map).setUpdateMask("names").setReadMask("names,emailAddresses");

BatchUpdateContactsResponse response =
    peopleService.people().batchUpdateContacts(request).execute();

हर अनुरोध के लिए कोटा का इस्तेमाल

  • पढ़े जाने के 6 ज़रूरी अनुरोध (संपर्क और प्रोफ़ाइल को पढ़ना)
  • 6 महत्वपूर्ण लिखने के अनुरोध (संपर्क बनाए और अपडेट)
  • हर दिन संपर्क के लिए 200 बार लिखे गए (कुल)

मौजूदा संपर्कों को बैच में मिटाएं

एक साथ कई मौजूदा संपर्कों को मिटाने के लिए, इस कोड का इस्तेमाल करें:

प्रोटोकॉल

POST /v1/people:batchDeleteContacts HTTP/1.1
Body: {"resource_names": ["resource_name"]}
Host: people.googleapis.com

Java

BatchDeleteContactsRequest request = new BatchDeleteContactsRequest();

request.setResourceNames(ImmutableList.of(resource_name));

peopleService.people().batchDeleteContacts(request).execute();

हर अनुरोध के लिए कोटा का इस्तेमाल

  • 10 अनुरोध लिखें (संपर्कों को मिटाने के लिए और संपर्क ग्रुप को लिखने के लिए)