पढ़ें, कॉपी करें, और खोजें "अन्य संपर्क"

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

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

उपयोगकर्ता के "अन्य संपर्क" सूची में शामिल करें

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

प्रोटोकॉल

GET /v1/otherContacts?readMask=names,emailAddresses HTTP/1.1
Host: people.googleapis.com

Java

ListOtherContactsResponse response = peopleService.otherContacts().list()
    .setReadMask("metadata,names,emailAddresses")
    .execute();

List<Person> otherContacts = response.getOtherContacts();

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

Java

// Initial request
ListOtherContactsResponse fullSyncResponse = peopleService.otherContacts().list()
    .setReadMask("metadata,names,emailAddresses")
    .setRequestSyncToken(true)
    .execute();
// Fetch all the pages
while (fullSyncResponse.getNextPageToken() != null) {
  fullSyncResponse = peopleService.otherContacts().list()
      .setReadMask("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 {
  ListOtherContactsResponse incrementalSyncResponse = peopleService.otherContacts().list()
      .setReadMask("metadata,names,emailAddresses")
      .setSyncToken(fullSyncResponse.getNextSyncToken())
      .execute();
  for (Person person : incrementalSyncResponse.getOtherContacts()) {
    handlePerson(person);
  }
  
  // Fetch all the pages
  while (!incrementalSyncResponse.getNextPageToken().isEmpty()) {
    incrementalSyncResponse = peopleService.otherContacts().list()
        .setReadMask("metadata,names,emailAddresses")
        .setSyncToken(fullSyncResponse.getNextSyncToken())
        .setPageToken(incrementalSyncResponse.getNextPageToken())
        .execute();
    for (Person person : incrementalSyncResponse.getOtherContacts()) {
      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
  }
}

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

किसी "अन्य संपर्क" को "myContacts" ग्रुप में कॉपी करना

किसी "अन्य संपर्क" को "myContacts" ग्रुप में कॉपी करने के लिए, इस कोड का इस्तेमाल करें:

प्रोटोकॉल

POST /v1/resource_name:copyOtherContactToMyContactsGroup?copyMask=names,emailAddresses,phoneNumbers HTTP/1.1
Host: people.googleapis.com

Java

Person copiedContact = peopleService
    .otherContacts()
    .copyOtherContactToMyContactsGroup(
        "resource_name",
        new CopyOtherContactToMyContactsGroupRequest()
            .setCopyMask("names,emailAddresses,phoneNumbers"))
    .execute();

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

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

प्रोटोकॉल

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

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

Java

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

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

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