Contacts: get

需要授权

根据 ID 获取单个联系人。 查看示例

请求

HTTP 请求

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

参数

参数名称 说明
路径参数
id string 联系人的 ID。

授权

此请求需要获得下列范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/glass.timeline

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功,此方法将在响应正文中返回一项 Contacts 资源

示例

注意:此方法的代码示例并未列出所有受支持的编程语言(请参阅客户端库页面,查看受支持的语言列表)。

使用 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 客户端库

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 客户端库

/*
 * 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 客户端库

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 客户端库

##
# 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 客户端库

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
}

不使用客户端库。

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