Contacts: list

يتطلب تفويضًا

لاسترداد قائمة جهات الاتصال للمستخدم الذي تمت المصادقة عليه. اطّلِع على مثال.

طلب

طلب HTTP

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

التفويض

ويتطلب هذا الطلب تفويضًا من خلال النطاق التالي (اقرأ المزيد عن المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/glass.timeline

نص الطلب

لا توفر نص طلب بهذه الطريقة.

الإجابة

إذا نجحت هذه الطريقة، فإنها تعرض نص الاستجابة بالبنية التالية:

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

اسم الموقع	القيمة	الوصف	ملاحظات
kind	string	نوع المورد. هذا دائمًا mirror#contacts.
items[]	list	قائمة جهات الاتصال.

أمثلة

ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).

لغة 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.

تستخدم مكتبة عميل 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

لاستخدام مكتبة عميل 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

استخدام مكتبة عميل 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

استخدام مكتبة عملاء 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

البدء

تستخدم مكتبة برامج 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 غير منسق

لا يتم استخدام مكتبة العميل.

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