Contacts: list

Autorisierung erforderlich

Ruft eine Liste der Kontakte des authentifizierten Nutzers ab. Beispiel

Anfragen

HTTP-Anfrage

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

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung

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

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

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

Name der Eigenschaft	Wert	Beschreibung	Hinweise
kind	string	Der Ressourcentyp. Das ist immer mirror#contacts.
items[]	list	Kontaktliste.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

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

Verwendet die .NET-Clientbibliothek.

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

Verwendet die PHP-Clientbibliothek.

/**
 * 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

Verwendet die Python-Clientbibliothek.

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

Verwendet die Ruby-Clientbibliothek.

##
# 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

Einfach loslegen (Go)

Verwendet die Go-Clientbibliothek.

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
}

Rohes HTTP

Verwendet keine Clientbibliothek.

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