Timeline.attachments: list

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

عرض قائمة بالمرفقات لعنصر مخطط زمني. اطّلِع على مثال.

الطلب

طلب HTTP

GET https://www.googleapis.com/mirror/v1/timeline/itemId/attachments

المعلمات

اسم المعلَمة	القيمة	الوصف
مَعلمات المسار
itemId	string	رقم تعريف عنصر المخطط الزمني الذي يجب إدراج مرفقاته.

التفويض

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

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

نص الطلب

لا تقدِّم نص طلب باستخدام هذه الطريقة.

الرد

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

{
  "kind": "mirror#attachmentsList",
  "items": [
    timeline.attachments Resource
  ]
}

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

أمثلة

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

Java

تستخدم مكتبة برامج Java.

import com.google.api.services.mirror.Mirror;
import com.google.api.services.mirror.model.Attachment;
import com.google.api.services.mirror.model.AttachmentsListResponse;

import java.io.IOException;

public class MyClass {
  // ...

  /**
   * Print all attachments' metadata.
   * 
   * @param service Authorized Mirror service.
   * @param itemId ID of the timeline item the attachments belong to.
   */
  public static void printAllAttachmentsMetadata(Mirror service, String itemId) {
    try {
      AttachmentsListResponse attachments = service.timeline().attachments().list(itemId).execute();

      for (Attachment attachment : attachments.getItems()) {
        System.out.println("Attachment content type: " + attachment.getContentType());
        System.out.println("Attachment content URL: " + attachment.getContentUrl());
      }
    } catch (IOException e) {
      System.out.println("An error occured: " + e);
    }

  }

  // ...
}

NET.

لاستخدام مكتبة برامج .NET

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

public class MyClass {
  // ...

  /// <summary>
  /// Print all attachments' metadata.
  /// </summary>
  /// <param name="service">Authorized Mirror service.</param>
  /// <param name="itemId">ID of the timeline item the attachments belong to.</param>
  public static void PrintAllAttachmentsMetadata(MirrorService service, String itemId) {
    try {
      AttachmentsListResponse attachments = service.Timeline.Attachments.List(itemId).Fetch();

      foreach (Attachment attachment in attachments.Items) {
        Console.WriteLine("Attachment content type: " + attachment.ContentType);
        Console.WriteLine("Attachment content URL: " + attachment.ContentUrl);
      }
    } catch (Exception e) {
      Console.WriteLine("An error occurred: " + e.Message);
    }
  }

  // ...
}

PHP

لاستخدام مكتبة برامج PHP

/**
 * Print all attachments' metadata.
 *
 * @param Google_MirrorService $service Authorized Mirror service.
 * @param string $itemId ID of the timeline item the attachments belong to.
 */
function printAllAttachmentsMetadata($service, $itemId) {
  try {
    $attachments = $service->timeline_attachments->listTimelineAttachments(
        $itemId);

    foreach ($attachments->getItems() as $attachment) {
      print "Attachment content type: " . $attachment->getContentType() . "\n";
      print "Attachment content URL: " . $attachment->getContentUrl() . "\n";
    }
  } catch (Exception $e) {
    print "An error occurred: " . $e->getMessage();
  }
}

Python

تستخدم مكتبة برامج Python.

from apiclient import errors
# ...

def print_all_attachments_metadata(service, item_id):
  """Print all attachments' metadata.

  Args:
    service: Authorized Mirror service.
    item_id: ID of the timeline item the attachments belong to.
  """
  try:
    attachments = service.timeline().attachments().list(
        itemId=item_id).execute()
    for attachment in attachments.get('items', []):
      print 'Attachment content type: %s' % attachment['contentType']
      print 'Attachment content URL: %s' % attachment['contentUrl']
  except errors.HttpError, error:
    print 'An error occurred: %s' % error

Ruby

تستخدم مكتبة برامج Ruby.

##
# Print all attachments' metadata.
#
# @param [Google::APIClient] client
#   Authorized client instance.
# @param [String] item_id
#   ID of the timeline item the attachments belong to.
# @return nil
def print_all_attachments_metadata(client, item_id)
  mirror = client.discovered_api('mirror', 'v1')
  result = client.execute(
    :api_method => mirror.timeline.attachments.list,
    :parameters => { 'itemId' => item_id })
  if result.success?
    attachments = result.data
    attachments.items.each do |attachment|
      puts "Attachment content type: #{attachment.content_type}"
      puts "Attachment content URL: #{attachment.content_url}"
    end
  else
    puts "An error occurred: #{result.data['error']['message']}"
  end
end

HTTP غير مُنسّق

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

GET /mirror/v1/timeline/timeline item id/attachments HTTP/1.1
Host: www.googleapis.com
Authorization: Bearer auth token