Diposting oleh Amos Yuen, Software Engineer, dan Wesley Chun (@wescpy), Developer Advocate, G Suite

 Mulai hari ini, Google People API akan mendapatkan endpoints baru untuk kontak dan contact groups. Tahun lalu, kami meluncurkan Google People API dengan endpoints read-only yang direncanakan untuk menggantikan Contacts API yang lama. Kami selangkah lebih dekat ke tujuan itu dengan menambahkan write endpoints yang memungkinkan developer membuat, menghapus, dan memperbarui sebuah kontak. Selain itu, ada endpoints contact groups baru yang memungkinkan developer read dan write contact groups.

Aplikasi harus diberi wewenang untuk mengakses API, sehingga untuk memulai, Anda harus membuat project di Google Developers Console dengan People API yang diaktifkan untuk mendapatkan akses ke layanan ini. Semua langkah yang harus dilakukan bisa dilihat di sini. Jika Anda baru mengenal Google API dan/atau Developers Console, lihat video ini, video pertama dalam seri rangkaian video kami agar Anda lebih mudah memahaminya.


Setelah diotorisasi, Anda bisa membuat kontak baru seperti ini (menggunakan Koleksi Klien Google API untuk Java):
Person contactToCreate = new Person();

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

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

Cakupan yang perlu diotorisasi aplikasi Anda adalah https://www.googleapis.com/auth/contacts. Dokumentasi lengkap tentang metode people.create tersedia di sini. Anda bisa memperbarui kontak yang ada seperti ini:

String resourceName = "people/c12345"; // existing contact resource name
Person contactToUpdate = peopleService.people().get(resourceName)
    .setPersonFields("names,emailAddresses")
    .execute();

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

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

Dokumentasi lengkap tentang metode people.update  tersedia di sini. Kami menunggu apa yang bisa Anda lakukan dengan fitur baru ini yang memungkinkan Anda untuk mengubah kontak. Untuk mempelajari lebih lanjut tentang People API, lihat dokumentasi resmi di sini.