Contacts: list

Requiere autorización.

Recupera una lista de contactos del usuario autenticado. Ve un ejemplo.

Solicitud

Solicitud HTTP

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

Autorización

Esta solicitud requiere autorización con el siguiente alcance (obtén más información sobre la autenticación y autorización).

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

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud con este método.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "mirror#contacts",
  "items": [
    contacts Resource
  ]
}

Nombre de la propiedad	Valor	Descripción	Notas
kind	string	El tipo de recurso. Siempre es mirror#contacts.
items[]	list	Lista de contactos.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas cliente para consultar una lista de lenguajes admitidos).

Java

Usa la biblioteca cliente de Java.

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

import java.io.IOException;

public class MyClass {
  // ...

  /**
   * Print all contacts for the current user.
   * 
   * @param service Authorized Mirror service.
   */
  public void printAllContacts(Mirror service) {
    try {
      ContactsListResponse contacts = service.contacts().list().execute();

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

  // ...
}

.NET

Usa la biblioteca cliente .NET.

using System;

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

public class MyClass {
  // ...

  /// <summary>
  /// Print all contacts for the current user.
  /// </summary>
  /// <param name='service'>Authorized Mirror service.</param>
  public static void PrintAllContacts(MirrorService service) {
    try {
      ContactsListResponse contacts =
          service.Contacts.List().Fetch();

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

  // ...
}

PHP

Usa la biblioteca cliente PHP.

/**
 * Print all contacts for the current user.
 *
 * @param Google_MirrorService service Authorized Mirror service.
 */
function printAllContacts($service) {
  try {
    $contacts = $service->contacts->listContacts();

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

Python

Usa la biblioteca cliente de Python.

from apiclient import errors
# ...

def print_all_contacts(service):
  """Print all contacts for the current user.

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

Ruby

Usa la biblioteca cliente de Ruby.

##
# Print all contacts for the current user.
#
# @param [Google::APIClient] client
#   Authorized client instance.
# @return nil
def print_all_contacts(client)
  mirror = client.discovered_api('mirror', 'v1')
  result = client.execute(:api_method => mirror.contacts.list)
  if result.success?
    contacts = result.data
    contacts.items.each do |contact|
      puts "Contact ID: #{contact.id}"
      puts "  > displayName: #{contact.display_name}"
      contact['imageUrls'].each do |image_url|
        puts "  > imageUrl: #{image_url}"
      end
    end
  else
    puts "An error occurred: #{result.data['error']['message']}"
  end
end

Comienza a usarlo

Usa la biblioteca cliente de Go.

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

// PrintAllContacts prints all contacts for the current user.
func PrintAllContacts(g *mirror.Service) error {
        s, err := g.Contacts.List().Do()
        if err != nil {
                fmt.Printf("An error occurred: %v\n", err)
                return err
        }
        for _, st := range s.Items {
                fmt.Printf("Contact ID: %s\n", st.Id)
                fmt.Printf("  > displayName: %s\n", st.DisplayName)
                for _, i := range st.ImageUrls {
                    fmt.Printf("  > imageUrl: %s\n", i)
                }
        }
        return nil
}

HTTP sin procesar

No usa una biblioteca cliente.

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