使用Google API修改谷歌联系人

Question

我想开始使用Google API与.NET客户端进行开发。对于第一步，我试图让所有的谷歌联系人，现在我想插入联系人。 我已经阅读了很多关于Google API的CRUD（创建，读取，更新和删除）联系人的信息。有联系人API，人员API和其他（？）。什么是CRUD联系人的最佳方式？

UserCredential credential = GoogleWebAuthorizationBroker.AuthorizeAsync(
    new ClientSecrets 
    { 
    ClientId = "xyz.apps.googleusercontent.com", 
    ClientSecret = " xyz" 
    }, 
    new[] { "profile", "https://www.google.com/m8/feeds/contacts/xy%40gmail.com/full" }, 
    "me", 
    CancellationToken.None).Result; 

// Create the service. 
var peopleService = new PeopleService(new BaseClientService.Initializer() 
{ 
    HttpClientInitializer = credential, 
    ApplicationName = "WindowsClient-Google-Sync", 
}); 

ListRequest listRequest = peopleService.People.Connections.List("people/me"); 
listRequest.SyncToken = null; 
ListConnectionsResponse result = listRequest.Execute(); 

foreach (Person person in result.Connections) 
{ 
    foreach (Name name in person.Names) 
    { 
    Console.WriteLine("Name: " + name.DisplayName); 
    } 
} 

如何扩展此示例以创建或更新联系人？

感谢

安德烈亚斯

Answer 1

如果您将检查Google Contacts API：

The Google Contacts API allows client applications to view and update a user's contacts. Contacts are stored in the user's Google Account; most Google services have access to the contact list.

Your client application can use the Google Contacts API to create new contacts, edit or delete existing contacts, and query for contacts that match particular criteria

创建联系

To create a new contact, send an authorized POST request to the user's contacts feed URL with contact data in the body.

的URL的形式为：

https://www.google.com/m8/feeds/contacts/{userEmail}/full 

Upon success, the server responds with an HTTP 201 Created status code and the created contact entry with some additional elements and properties (shown in bold) that are set by the server, such as id, various link elements and properties.

import com.google.gdata.client.contacts.ContactsService; 
import com.google.gdata.data.contacts.ContactEntry; 
import com.google.gdata.data.contacts.ContactGroupFeed; 
import com.google.gdata.data.extensions.City; 
import com.google.gdata.data.extensions.Country; 
import com.google.gdata.data.extensions.Email; 
import com.google.gdata.data.extensions.ExtendedProperty; 
import com.google.gdata.data.extensions.FormattedAddress; 
import com.google.gdata.data.extensions.FullName; 
import com.google.gdata.data.extensions.Im; 
import com.google.gdata.data.extensions.Name; 
import com.google.gdata.data.extensions.PhoneNumber; 
import com.google.gdata.data.extensions.PostCode; 
import com.google.gdata.data.extensions.Region; 
import com.google.gdata.data.extensions.Street; 
import com.google.gdata.data.extensions.StructuredPostalAddress; 
// ... 
public static ContactEntry createContact(ContactsService myService) { 
    // Create the entry to insert. 
    ContactEntry contact = new ContactEntry(); 
    // Set the contact's name. 
    Name name = new Name(); 
    final String NO_YOMI = null; 
    name.setFullName(new FullName("Elizabeth Bennet", NO_YOMI)); 
    name.setGivenName(new GivenName("Elizabeth", NO_YOMI)); 
    name.setFamilyName(new FamilyName("Bennet", NO_YOMI)) 
    contact.setName(name); 
    contact.setContent(new PlainTextConstruct("Notes")); 
    // Set contact's e-mail addresses. 
    Email primaryMail = new Email(); 
    primaryMail.setAddress("liz@gmail.com"); 
    primaryMail.setDisplayName("E. Bennet"); 
    primaryMail.setRel("http://schemas.google.com/g/2005#home"); 
    primaryMail.setPrimary(true); 
    contact.addEmailAddress(primaryMail); 
    Email secondaryMail = new Email(); 
    secondaryMail.setAddress("liz@example.com"); 
    secondaryMail.setRel("http://schemas.google.com/g/2005#work"); 
    secondaryMail.setPrimary(false); 
    contact.addEmailAddress(secondaryMail); 
    // Set contact's phone numbers. 
    PhoneNumber primaryPhoneNumber = new PhoneNumber(); 
    primaryPhoneNumber.setPhoneNumber("(206)555-1212"); 
    primaryPhoneNumber.setRel("http://schemas.google.com/g/2005#work"); 
    primaryPhoneNumber.setPrimary(true); 
    contact.addPhoneNumber(primaryPhoneNumber); 
    PhoneNumber secondaryPhoneNumber = new PhoneNumber(); 
    secondaryPhoneNumber.setPhoneNumber("(206)555-1213"); 
    secondaryPhoneNumber.setRel("http://schemas.google.com/g/2005#home"); 
    contact.addPhoneNumber(secondaryPhoneNumber); 
    // Set contact's IM information. 
    Im imAddress = new Im(); 
    imAddress.setAddress("liz@gmail.com"); 
    imAddress.setRel("http://schemas.google.com/g/2005#home"); 
    imAddress.setProtocol("http://schemas.google.com/g/2005#GOOGLE_TALK"); 
    imAddress.setPrimary(true); 
    contact.addImAddress(imAddress); 
    // Set contact's postal address. 
    StructuredPostalAddress postalAddress = new StructuredPostalAddress(); 
    postalAddress.setStreet(new Street("1600 Amphitheatre Pkwy")); 
    postalAddress.setCity(new City("Mountain View")); 
    postalAddress.setRegion(new Region("CA")); 
    postalAddress.setPostcode(new PostCode("94043")); 
    postalAddress.setCountry(new Country("US", "United States")); 
    postalAddress.setFormattedAddress(new FormattedAddress("1600 Amphitheatre Pkwy Mountain View")); 
    postalAddress.setRel("http://schemas.google.com/g/2005#work"); 
    postalAddress.setPrimary(true); 
    contactOne.addStructuredPostalAddress(postalAddress); 
    // Ask the service to insert the new entry 
    URL postUrl = new URL("https://www.google.com/m8/feeds/contacts/default/full"); 
    ContactEntry createdContact = myService.insert(postUrl, contact); 
    System.out.println("Contact's ID: " + createdContact.getId()); 
    return createdContact; 
} 

更新联系人

To update a contact, first retrieve the contact entry, modify the data and send an authorized PUT request to the contact's edit URL with the modified contact entry in the body.

的URL的形式为：

https://www.google.com/m8/feeds/contacts/userEmail/full/{contactId} 

为了确保发送到API的数据不会覆盖另一个客户端的变化，联系人条目的Etag应该在请求头中提供。

If-Match: Etag 

成功后，服务器与HTTP 200 OK状态代码和更新的联系人条目响应。

public static ContactEntry updateContactName(
    ContactsService myService, URL contactURL) 
    throws ServiceException, IOException { 
    // First retrieve the contact to updated. 
    ContactEntry entryToUpdate = myService.getEntry(contactURL, ContactEntry.class); 
    entryToUpdate.getName().getFullName().setValue("New Name"); 
    entryToUpdate.getName().getGivenName().setValue("New"); 
    entryToUpdate.getName().getFamilyName().setValue("Name"); 
    URL editUrl = new URL(entryToUpdate.getEditLink().getHref()); 
    try { 
    ContactEntry contactEntry = myService.update(editUrl, entryToUpdate); 
    System.out.println("Updated: " + contactEntry.getUpdated().toString()); 
    return contactEntry; 
    } catch (PreconditionFailedException e) { 
    // Etags mismatch: handle the exception. 
    } 
    return null; 
} 

删除联系人

要删除联系人，发送授权DELETE请求到联系人的编辑URL。

的URL的形式是：

https://www.google.com/m8/feeds/contacts/{userEmail}/full/{contactId} 

为了确保发送到API中的数据不会覆盖另一客户端的改变，联系人条目的Etag的，应在请求报头中提供。

If-Match: Etag 

一旦成功，服务器会回应一个HTTP 200 OK状态码。

public static void deleteContact(ContactsService myService, URL contactURL) 
    throws ServiceException, IOException { 
    // Retrieving the contact is required in order to get the Etag. 
    ContactEntry contact = myService.getEntry(contactURL, ContactEntry.class); 

    try { 
    contact.delete(); 
    } catch (PreconditionFailedException e) { 
    // Etags mismatch: handle the exception. 
    } 
} 

而People API：

The People API lets you list authenticated users' Contacts and retrieve profile information for authenticated users and their contacts.

For example, let's say the authenticated user, Jen, has Fabian and Ranjith in her private contacts. When your app calls people.connections.list to retrieve a list of her connections, Jen is presented with a consent screen asking to give the app access to the list. If Jen consents, the app retrieves a list containing Fabian and Ranjith (with a resource name for each person). The app can then call people.get, passing in a resource name, to get private contact and public profile data for each person.