Contacts: get

Cần phải uỷ quyền

Lấy một người liên hệ theo mã nhận dạng. Xem ví dụ.

Yêu cầu

Yêu cầu HTTP

GET https://www.googleapis.com/mirror/v1/contacts/id

Tham số

Tên thông số	Giá trị	Mô tả
Tham số đường dẫn
id	string	Mã của người liên hệ.

Ủy quyền

Yêu cầu này cần có sự cho phép có phạm vi sau (đọc thêm về quy trình xác thực và uỷ quyền).

Phạm vi
https://www.googleapis.com/auth/glass.timeline

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một Tài nguyên danh bạ trong nội dung phản hồi.

Ví dụ

Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).

Java

Dùng thư viện ứng dụng Java.

import com.google.api.services.mirror.Mirror;
import com.google.api.services.mirror.model.Contact;

import java.io.IOException;

public class MyClass {
  // ...

  /**
   * Print information for a contact.
   * 
   * @param service Authorized Mirror service.
   * @param contactId ID of the Contact to print information for.
   */
  public static void printContact(Mirror service, String contactId) {
    try {
      Contact contact = service.contacts().get(contactId).execute();

      System.out.println("Contact displayName: " + contact.getDisplayName());
      if (contact.getImageUrls() != null) {
        for (String imageUrl : contact.getImagesUrls()) {
          System.out.println("Contact imageUrl: " + imageUrl);
        }
      }
    } catch (IOException e) {
      System.err.println("An error occurred: " + e);
    }
  }

  // ...
}

.NET

Dùng thư viện ứng dụng.NET.

using System;

using Google.Apis.Mirror.v1;
using Google.Apis.Mirror.v1.Data;

public class MyClass {
  // ...

  /// <summary>
  /// Print information for a contact.
  /// </summary>
  /// <param name='service'>Authorized Mirror service</param>
  /// <param name='contactId'>
  /// ID of the Contact to print information for.
  /// </param>
  public static void PrintContact(MirrorService service,
      String contactId) {
    try {
      Contact contact = service.Contacts.Get(contactId).Fetch();

      Console.WriteLine(
          "Contact displayName: " + contact.DisplayName);
      if (contact.ImageUrls != null) {
        foreach (String imageUrl in contact.ImageUrls) {
          Console.WriteLine("Contact imageUrl: " + imageUrl);
        }
      }
    } catch (Exception e) {
      Console.WriteLine("An error occurred: " + e.Message);
    }
  }

  // ...
}

PHP

Dùng thư viện ứng dụng PHP.

/*
 * Print information for a contact.
 *
 * @param Google_MirrorService $service Authorized Mirror service.
 * @param string $contactId ID of the Contact to print information for.
 */
function printContact($service, $contactId) {
  try {
    $contact = $service->contacts->get($contactId);

    print 'Contact displayName: ' . $contact->getDisplayName();
    if ($contact->getImageUrls() != null) {
      foreach ($contact->getImageUrls() as $imageUrl) {
        print 'Contact imageUrl: ' . $imageUrl;
      }
    }
  } catch (Exception $e) {
    print 'An error occurred: ' . $e->getMessage();
  }
}

Python

Dùng thư viện ứng dụng Python.

from apiclient import errors
# ...

def print_contact(service, contact_id):
  """Print information for a contact.

  Args:
    service: Authorized Mirror service.
    contact_id: ID of the Contact to print information for.
  """
  try:
    contact = service.contacts().get(id= contact_id).execute()
    print 'Contact displayName: %s' % contact.get('displayName')
    for image_url in contact.get('imageUrls', []):
      print 'Contact imageUrl: %s' % image_url
  except errors.HttpError, error:
    print 'An error occurred: %s' % error

Ruby

Dùng thư viện ứng dụng Ruby.

##
# Print information for a contact.
#
# @param [Google::APIClient] client
#   Authorized client instance.
# @param [String] contact_id
#   ID of the contact to print information for.
# @return nil
def print_contact(client, contact_id)
  mirror = client.discovered_api('mirror', 'v1')
  result = client.execute(
    :api_method => mirror.contacts.get,
    :parameters => { 'id' => contact_id })
  if result.success?
    contact = result.data
    puts "Contact displayName: #{contact.displayName}"
    contact.image_urls.each do |image_url|
      puts "Contact imageUrl: #{image_url}"
    end
  else
    puts "An error occurred: #{result.data['error']['message']}"
  end
end

Go

Dùng Thư viện ứng dụng Go.

import (
        "code.google.com/p/google-api-go-client/mirror/v1"
        "fmt"
)

// PrintContact prints information for a contact.
func PrintContact(g *mirror.Service, contactId string) error {
        s, err := g.Contacts.Get(contactId).Do()
        if err != nil {
                fmt.Printf("An error occurred: %v\n", err)
                return err
        }
        fmt.Printf("Contact displayName: %s\n", s.DisplayName)
        for _, i := range s.ImageUrls {
                fmt.Printf("Contact imageUrl: %s\n", i)
        }
        return nil
}

HTTP thô

Không sử dụng thư viện ứng dụng.

GET /mirror/v1/contacts/harold HTTP/1.1
Authorization: Bearer auth token