Timeline.attachments: list

Stay organized with collections Save and categorize content based on your preferences.

Requires authorization

Returns a list of attachments for a timeline item. See an example.


HTTP request

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


Parameter name Value Description
Path parameters
itemId string The ID of the timeline item whose attachments should be listed.


This request requires authorization with the following scope (read more about authentication and authorization).


Request body

Do not supply a request body with this method.


If successful, this method returns a response body with the following structure:

  "kind": "mirror#attachmentsList",
  "items": [
    timeline.attachments Resource
Property name Value Description Notes
kind string The type of resource. This is always mirror#attachmentsList.
items[] list The list of attachments.


Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).


Uses the Java client library.

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


  // ...


Uses the .NET client library.

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

  // ...


Uses the PHP client library.

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

    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();


Uses the Python client library.

from apiclient import errors
# ...

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

    service: Authorized Mirror service.
    item_id: ID of the timeline item the attachments belong to.
    attachments = service.timeline().attachments().list(
    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


Uses the Ruby client library.

# 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}"
    puts "An error occurred: #{result.data['error']['message']}"


Does not use a client library.

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