Contacts: get

Autorisierung erforderlich

Ruft einen einzelnen Kontakt nach ID ab. Beispiel ansehen

Anfrage

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Pfadparameter
id string Die ID des Kontakts.

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

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ressource vom Typ "Kontakte" im Antworttext zurückgegeben.

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

Verwendet die .NET-Clientbibliothek.

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

Verwendet die PHP-Clientbibliothek.

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

Verwendet die Python-Clientbibliothek.

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

Verwendet die Ruby-Clientbibliothek.

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

Ok

Verwendet die Go-Clientbibliothek.

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

Verwendet keine Clientbibliothek.

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