Contacts: get

Richiede l'autorizzazione

Recupera un singolo contatto per ID. Vedi un esempio.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro	Valore	Descrizione
Parametri percorso
id	string	L'ID del contatto.

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito (scopri di più su autenticazione e autorizzazione).

Ambito
https://www.googleapis.com/auth/glass.timeline

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa Contatti nel corpo della risposta.

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client 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

Utilizza la libreria client.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

Utilizza la libreria client 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

Utilizza la libreria client 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

Utilizza la libreria client 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

Vai

Utilizza la libreria client 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 non elaborato

Non utilizza una libreria client.

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