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

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

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

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

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

प्रोटोकॉलJavaPythonPHP.NET
GET /v1/people/me/connections?personFields=names,emailAddresses HTTP/1.1
Host: people.googleapis.com
 
ListConnectionsResponse response = peopleService.people().connections().list("people/me")
    .setPersonFields("names,emailAddresses")
    .execute();
List<Person> people = response.getConnections();
 
people = people_service.people().connections()
    .list('people/me', personFields='names,emailAddresses')
 
$people = $people_service->people_connections->listPeopleConnections(
    'people/me', array('personFields' => 'names,emailAddresses'));
 
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 पर जाएं.

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

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

प्रोटोकॉलJava
// 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
 
// 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();

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

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

प्रोटोकॉलJava
POST /v1/people:createContact HTTP/1.1
Body: { "names": [{ "givenName": "John", "familyName": "Doe" }] }
Host: people.googleapis.com
 
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();

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

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

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

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

प्रोटोकॉलJava
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
 
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();

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

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

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

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

प्रोटोकॉलJava
DELETE /v1/resource_name:deleteContact HTTP/1.1
Host: people.googleapis.com
 
peopleService.people().deleteContact("resource_name").execute();

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

  • डेटा में बदलाव करने के एक अनुरोध (संपर्क मिटाने और संपर्क ग्रुप में बदलाव करने के अनुरोध)

एक साथ कई नए संपर्क बनाना

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

प्रोटोकॉलJava
POST /v1/people:batchCreateContacts?readMask=names HTTP/1.1
Body: {
  "contacts": [
    {
      "contactPerson": {
        "names": [
          {
            "givenName": "John",
            "familyName": "Doe"
          }
        ]
      }
    }
  ]
}
Host: people.googleapis.com
 
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();

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

  • छह ज़रूरी अनुरोध, जिनमें संपर्क और प्रोफ़ाइल की जानकारी पढ़ने का अनुरोध शामिल है
  • डेटा को लिखने के छह अहम अनुरोध (संपर्क बनाने और अपडेट करने के लिए)
  • हर रोज़ 200 संपर्कों की जानकारी लिखी जा सकती है (कुल)

मौजूदा संपर्कों को एक साथ अपडेट करना

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

प्रोटोकॉलJava
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
 
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();

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

  • छह ज़रूरी अनुरोध, जिनमें संपर्क और प्रोफ़ाइल की जानकारी पढ़ने का अनुरोध शामिल है
  • डेटा को लिखने के छह अहम अनुरोध (संपर्क बनाने और अपडेट करने के लिए)
  • हर रोज़ 200 संपर्कों की जानकारी लिखी जा सकती है (कुल)

एक साथ कई मौजूदा संपर्क मिटाना

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

प्रोटोकॉलJava
POST /v1/people:batchDeleteContacts HTTP/1.1
Body: {"resource_names": ["resource_name"]}
Host: people.googleapis.com
 
BatchDeleteContactsRequest request = new BatchDeleteContactsRequest();

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

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

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

  • डेटा में बदलाव करने के 10 अनुरोध (संपर्क मिटाने और संपर्क ग्रुप में बदलाव करने के अनुरोध)