Timeline.attachments: list

需要授权

返回时间轴项的附件列表。 查看示例

请求

HTTP 请求

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

参数

参数名称 说明
路径参数
itemId string 应列出其附件的时间轴项的 ID。

授权

此请求需要获得下列范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/glass.timeline

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功,此方法将返回采用以下结构的响应正文:

{
 
"kind": "mirror#attachmentsList",
 
"items": [
   
timeline.attachments Resource
 
]
}
属性名称 说明 备注
kind string 资源类型。始终为 mirror#attachmentsList
items[] list 附件列表。

示例

注意:此方法的代码示例并未列出所有受支持的编程语言(请参阅客户端库页面,查看受支持的语言列表)。

使用 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 客户端库

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 客户端库

/**
 * 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 客户端库

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 客户端库

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

不使用客户端库。

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