2019-03-17 20:19:56 +01:00
// Copyright 2019 Google LLC.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
// Code generated file. DO NOT EDIT.
// Package appsactivity provides access to the Drive Activity API.
//
// For product documentation, see: https://developers.google.com/google-apps/activity/
2018-06-19 15:30:26 +02:00
//
2019-03-17 20:19:56 +01:00
// Creating a client
2018-06-19 15:30:26 +02:00
//
// Usage example:
//
// import "google.golang.org/api/appsactivity/v1"
// ...
2019-03-17 20:19:56 +01:00
// ctx := context.Background()
// appsactivityService, err := appsactivity.NewService(ctx)
//
// In this example, Google Application Default Credentials are used for authentication.
//
// For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
//
// Other authentication options
//
// To use an API key for authentication (note: some APIs do not support API keys), use option.WithAPIKey:
//
// appsactivityService, err := appsactivity.NewService(ctx, option.WithAPIKey("AIza..."))
//
// To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow), use option.WithTokenSource:
//
// config := &oauth2.Config{...}
// // ...
// token, err := config.Exchange(ctx, ...)
// appsactivityService, err := appsactivity.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
//
// See https://godoc.org/google.golang.org/api/option/ for details on options.
2018-06-19 15:30:26 +02:00
package appsactivity // import "google.golang.org/api/appsactivity/v1"
import (
"bytes"
2019-03-17 20:19:56 +01:00
"context"
2018-06-19 15:30:26 +02:00
"encoding/json"
"errors"
"fmt"
"io"
"net/http"
"net/url"
"strconv"
"strings"
2019-03-17 20:19:56 +01:00
gensupport "google.golang.org/api/gensupport"
googleapi "google.golang.org/api/googleapi"
option "google.golang.org/api/option"
htransport "google.golang.org/api/transport/http"
2018-06-19 15:30:26 +02:00
)
// Always reference these packages, just in case the auto-generated code
// below doesn't.
var _ = bytes . NewBuffer
var _ = strconv . Itoa
var _ = fmt . Sprintf
var _ = json . NewDecoder
var _ = io . Copy
var _ = url . Parse
var _ = gensupport . MarshalJSON
var _ = googleapi . Version
var _ = errors . New
var _ = strings . Replace
var _ = context . Canceled
const apiId = "appsactivity:v1"
const apiName = "appsactivity"
const apiVersion = "v1"
const basePath = "https://www.googleapis.com/appsactivity/v1/"
// OAuth2 scopes used by this API.
const (
// View the activity history of your Google apps
ActivityScope = "https://www.googleapis.com/auth/activity"
)
2019-03-17 20:19:56 +01:00
// NewService creates a new Service.
func NewService ( ctx context . Context , opts ... option . ClientOption ) ( * Service , error ) {
scopesOption := option . WithScopes (
"https://www.googleapis.com/auth/activity" ,
)
// NOTE: prepend, so we don't override user-specified scopes.
opts = append ( [ ] option . ClientOption { scopesOption } , opts ... )
client , endpoint , err := htransport . NewClient ( ctx , opts ... )
if err != nil {
return nil , err
}
s , err := New ( client )
if err != nil {
return nil , err
}
if endpoint != "" {
s . BasePath = endpoint
}
return s , nil
}
// New creates a new Service. It uses the provided http.Client for requests.
//
// Deprecated: please use NewService instead.
// To provide a custom HTTP client, use option.WithHTTPClient.
// If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.
2018-06-19 15:30:26 +02:00
func New ( client * http . Client ) ( * Service , error ) {
if client == nil {
return nil , errors . New ( "client is nil" )
}
s := & Service { client : client , BasePath : basePath }
s . Activities = NewActivitiesService ( s )
return s , nil
}
type Service struct {
client * http . Client
BasePath string // API endpoint base URL
UserAgent string // optional additional User-Agent fragment
Activities * ActivitiesService
}
func ( s * Service ) userAgent ( ) string {
if s . UserAgent == "" {
return googleapi . UserAgent
}
return googleapi . UserAgent + " " + s . UserAgent
}
func NewActivitiesService ( s * Service ) * ActivitiesService {
rs := & ActivitiesService { s : s }
return rs
}
type ActivitiesService struct {
s * Service
}
// Activity: An Activity resource is a combined view of multiple events.
// An activity has a list of individual events and a combined view of
// the common fields among all events.
type Activity struct {
// CombinedEvent: The fields common to all of the singleEvents that make
// up the Activity.
CombinedEvent * Event ` json:"combinedEvent,omitempty" `
// SingleEvents: A list of all the Events that make up the Activity.
SingleEvents [ ] * Event ` json:"singleEvents,omitempty" `
// ForceSendFields is a list of field names (e.g. "CombinedEvent") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "CombinedEvent") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Activity ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Activity
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Event: Represents the changes associated with an action taken by a
// user.
type Event struct {
// AdditionalEventTypes: Additional event types. Some events may have
// multiple types when multiple actions are part of a single event. For
// example, creating a document, renaming it, and sharing it may be part
// of a single file-creation event.
//
// Possible values:
// "comment"
// "create"
// "edit"
// "emptyTrash"
// "move"
// "permissionChange"
// "rename"
// "trash"
// "unknown"
// "untrash"
// "upload"
AdditionalEventTypes [ ] string ` json:"additionalEventTypes,omitempty" `
// EventTimeMillis: The time at which the event occurred formatted as
// Unix time in milliseconds.
EventTimeMillis uint64 ` json:"eventTimeMillis,omitempty,string" `
// FromUserDeletion: Whether this event is caused by a user being
// deleted.
FromUserDeletion bool ` json:"fromUserDeletion,omitempty" `
// Move: Extra information for move type events, such as changes in an
// object's parents.
Move * Move ` json:"move,omitempty" `
// PermissionChanges: Extra information for permissionChange type
// events, such as the user or group the new permission applies to.
PermissionChanges [ ] * PermissionChange ` json:"permissionChanges,omitempty" `
// PrimaryEventType: The main type of event that occurred.
//
// Possible values:
// "comment"
// "create"
// "edit"
// "emptyTrash"
// "move"
// "permissionChange"
// "rename"
// "trash"
// "unknown"
// "untrash"
// "upload"
PrimaryEventType string ` json:"primaryEventType,omitempty" `
// Rename: Extra information for rename type events, such as the old and
// new names.
Rename * Rename ` json:"rename,omitempty" `
// Target: Information specific to the Target object modified by the
// event.
Target * Target ` json:"target,omitempty" `
// User: Represents the user responsible for the event.
User * User ` json:"user,omitempty" `
// ForceSendFields is a list of field names (e.g.
// "AdditionalEventTypes") to unconditionally include in API requests.
// By default, fields with empty values are omitted from API requests.
// However, any non-pointer, non-interface field appearing in
// ForceSendFields will be sent to the server regardless of whether the
// field is empty or not. This may be used to include empty fields in
// Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "AdditionalEventTypes") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Event ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Event
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// ListActivitiesResponse: The response from the list request. Contains
// a list of activities and a token to retrieve the next page of
// results.
type ListActivitiesResponse struct {
// Activities: List of activities.
Activities [ ] * Activity ` json:"activities,omitempty" `
// NextPageToken: Token for the next page of results.
NextPageToken string ` json:"nextPageToken,omitempty" `
// ServerResponse contains the HTTP response code and headers from the
// server.
googleapi . ServerResponse ` json:"-" `
// ForceSendFields is a list of field names (e.g. "Activities") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Activities") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * ListActivitiesResponse ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod ListActivitiesResponse
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Move: Contains information about changes in an object's parents as a
// result of a move type event.
type Move struct {
// AddedParents: The added parent(s).
AddedParents [ ] * Parent ` json:"addedParents,omitempty" `
// RemovedParents: The removed parent(s).
RemovedParents [ ] * Parent ` json:"removedParents,omitempty" `
// ForceSendFields is a list of field names (e.g. "AddedParents") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "AddedParents") to include
// in API requests with the JSON null value. By default, fields with
// empty values are omitted from API requests. However, any field with
// an empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Move ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Move
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Parent: Contains information about a parent object. For example, a
// folder in Drive is a parent for all files within it.
type Parent struct {
// Id: The parent's ID.
Id string ` json:"id,omitempty" `
// IsRoot: Whether this is the root folder.
IsRoot bool ` json:"isRoot,omitempty" `
// Title: The parent's title.
Title string ` json:"title,omitempty" `
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Parent ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Parent
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Permission: Contains information about the permissions and type of
// access allowed with regards to a Google Drive object. This is a
// subset of the fields contained in a corresponding Drive Permissions
// object.
type Permission struct {
// Name: The name of the user or group the permission applies to.
Name string ` json:"name,omitempty" `
// PermissionId: The ID for this permission. Corresponds to the Drive
// API's permission ID returned as part of the Drive Permissions
// resource.
PermissionId string ` json:"permissionId,omitempty" `
// Role: Indicates the Google Drive permissions role. The role
// determines a user's ability to read, write, or comment on the file.
//
// Possible values:
// "commenter"
// "owner"
// "publishedReader"
// "reader"
// "writer"
Role string ` json:"role,omitempty" `
// Type: Indicates how widely permissions are granted.
//
// Possible values:
// "anyone"
// "domain"
// "group"
// "user"
Type string ` json:"type,omitempty" `
// User: The user's information if the type is USER.
User * User ` json:"user,omitempty" `
// WithLink: Whether the permission requires a link to the file.
WithLink bool ` json:"withLink,omitempty" `
// ForceSendFields is a list of field names (e.g. "Name") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Name") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Permission ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Permission
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// PermissionChange: Contains information about a Drive object's
// permissions that changed as a result of a permissionChange type
// event.
type PermissionChange struct {
// AddedPermissions: Lists all Permission objects added.
AddedPermissions [ ] * Permission ` json:"addedPermissions,omitempty" `
// RemovedPermissions: Lists all Permission objects removed.
RemovedPermissions [ ] * Permission ` json:"removedPermissions,omitempty" `
// ForceSendFields is a list of field names (e.g. "AddedPermissions") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "AddedPermissions") to
// include in API requests with the JSON null value. By default, fields
// with empty values are omitted from API requests. However, any field
// with an empty value appearing in NullFields will be sent to the
// server as null. It is an error if a field in this list has a
// non-empty value. This may be used to include null fields in Patch
// requests.
NullFields [ ] string ` json:"-" `
}
func ( s * PermissionChange ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod PermissionChange
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Photo: Photo information for a user.
type Photo struct {
// Url: The URL of the photo.
Url string ` json:"url,omitempty" `
// ForceSendFields is a list of field names (e.g. "Url") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Url") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Photo ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Photo
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Rename: Contains information about a renametype event.
type Rename struct {
// NewTitle: The new title.
NewTitle string ` json:"newTitle,omitempty" `
// OldTitle: The old title.
OldTitle string ` json:"oldTitle,omitempty" `
// ForceSendFields is a list of field names (e.g. "NewTitle") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "NewTitle") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Rename ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Rename
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// Target: Information about the object modified by the event.
type Target struct {
// Id: The ID of the target. For example, in Google Drive, this is the
// file or folder ID.
Id string ` json:"id,omitempty" `
// MimeType: The MIME type of the target.
MimeType string ` json:"mimeType,omitempty" `
// Name: The name of the target. For example, in Google Drive, this is
// the title of the file.
Name string ` json:"name,omitempty" `
// ForceSendFields is a list of field names (e.g. "Id") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "Id") to include in API
// requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * Target ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod Target
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// User: A representation of a user.
type User struct {
// IsDeleted: A boolean which indicates whether the specified User was
// deleted. If true, name, photo and permission_id will be omitted.
IsDeleted bool ` json:"isDeleted,omitempty" `
// IsMe: Whether the user is the authenticated user.
IsMe bool ` json:"isMe,omitempty" `
// Name: The displayable name of the user.
Name string ` json:"name,omitempty" `
// PermissionId: The permission ID associated with this user. Equivalent
// to the Drive API's permission ID for this user, returned as part of
// the Drive Permissions resource.
PermissionId string ` json:"permissionId,omitempty" `
// Photo: The profile photo of the user. Not present if the user has no
// profile photo.
Photo * Photo ` json:"photo,omitempty" `
// ForceSendFields is a list of field names (e.g. "IsDeleted") to
// unconditionally include in API requests. By default, fields with
// empty values are omitted from API requests. However, any non-pointer,
// non-interface field appearing in ForceSendFields will be sent to the
// server regardless of whether the field is empty or not. This may be
// used to include empty fields in Patch requests.
ForceSendFields [ ] string ` json:"-" `
// NullFields is a list of field names (e.g. "IsDeleted") to include in
// API requests with the JSON null value. By default, fields with empty
// values are omitted from API requests. However, any field with an
// empty value appearing in NullFields will be sent to the server as
// null. It is an error if a field in this list has a non-empty value.
// This may be used to include null fields in Patch requests.
NullFields [ ] string ` json:"-" `
}
func ( s * User ) MarshalJSON ( ) ( [ ] byte , error ) {
type NoMethod User
raw := NoMethod ( * s )
return gensupport . MarshalJSON ( raw , s . ForceSendFields , s . NullFields )
}
// method id "appsactivity.activities.list":
type ActivitiesListCall struct {
s * Service
urlParams_ gensupport . URLParams
ifNoneMatch_ string
ctx_ context . Context
header_ http . Header
}
// List: Returns a list of activities visible to the current logged in
// user. Visible activities are determined by the visiblity settings of
// the object that was acted on, e.g. Drive files a user can see. An
// activity is a record of past events. Multiple events may be merged if
// they are similar. A request is scoped to activities from a given
// Google service using the source parameter.
func ( r * ActivitiesService ) List ( ) * ActivitiesListCall {
c := & ActivitiesListCall { s : r . s , urlParams_ : make ( gensupport . URLParams ) }
return c
}
// DriveAncestorId sets the optional parameter "drive.ancestorId":
// Identifies the Drive folder containing the items for which to return
// activities.
func ( c * ActivitiesListCall ) DriveAncestorId ( driveAncestorId string ) * ActivitiesListCall {
c . urlParams_ . Set ( "drive.ancestorId" , driveAncestorId )
return c
}
// DriveFileId sets the optional parameter "drive.fileId": Identifies
// the Drive item to return activities for.
func ( c * ActivitiesListCall ) DriveFileId ( driveFileId string ) * ActivitiesListCall {
c . urlParams_ . Set ( "drive.fileId" , driveFileId )
return c
}
// GroupingStrategy sets the optional parameter "groupingStrategy":
// Indicates the strategy to use when grouping singleEvents items in the
// associated combinedEvent object.
//
// Possible values:
// "driveUi" (default)
// "none"
func ( c * ActivitiesListCall ) GroupingStrategy ( groupingStrategy string ) * ActivitiesListCall {
c . urlParams_ . Set ( "groupingStrategy" , groupingStrategy )
return c
}
// PageSize sets the optional parameter "pageSize": The maximum number
// of events to return on a page. The response includes a continuation
// token if there are more events.
func ( c * ActivitiesListCall ) PageSize ( pageSize int64 ) * ActivitiesListCall {
c . urlParams_ . Set ( "pageSize" , fmt . Sprint ( pageSize ) )
return c
}
// PageToken sets the optional parameter "pageToken": A token to
// retrieve a specific page of results.
func ( c * ActivitiesListCall ) PageToken ( pageToken string ) * ActivitiesListCall {
c . urlParams_ . Set ( "pageToken" , pageToken )
return c
}
// Source sets the optional parameter "source": The Google service from
// which to return activities. Possible values of source are:
// - drive.google.com
func ( c * ActivitiesListCall ) Source ( source string ) * ActivitiesListCall {
c . urlParams_ . Set ( "source" , source )
return c
}
// UserId sets the optional parameter "userId": Indicates the user to
// return activity for. Use the special value me to indicate the
// currently authenticated user.
func ( c * ActivitiesListCall ) UserId ( userId string ) * ActivitiesListCall {
c . urlParams_ . Set ( "userId" , userId )
return c
}
// Fields allows partial responses to be retrieved. See
// https://developers.google.com/gdata/docs/2.0/basics#PartialResponse
// for more information.
func ( c * ActivitiesListCall ) Fields ( s ... googleapi . Field ) * ActivitiesListCall {
c . urlParams_ . Set ( "fields" , googleapi . CombineFields ( s ) )
return c
}
// IfNoneMatch sets the optional parameter which makes the operation
// fail if the object's ETag matches the given value. This is useful for
// getting updates only after the object has changed since the last
// request. Use googleapi.IsNotModified to check whether the response
// error from Do is the result of In-None-Match.
func ( c * ActivitiesListCall ) IfNoneMatch ( entityTag string ) * ActivitiesListCall {
c . ifNoneMatch_ = entityTag
return c
}
// Context sets the context to be used in this call's Do method. Any
// pending HTTP request will be aborted if the provided context is
// canceled.
func ( c * ActivitiesListCall ) Context ( ctx context . Context ) * ActivitiesListCall {
c . ctx_ = ctx
return c
}
// Header returns an http.Header that can be modified by the caller to
// add HTTP headers to the request.
func ( c * ActivitiesListCall ) Header ( ) http . Header {
if c . header_ == nil {
c . header_ = make ( http . Header )
}
return c . header_
}
func ( c * ActivitiesListCall ) doRequest ( alt string ) ( * http . Response , error ) {
reqHeaders := make ( http . Header )
for k , v := range c . header_ {
reqHeaders [ k ] = v
}
reqHeaders . Set ( "User-Agent" , c . s . userAgent ( ) )
if c . ifNoneMatch_ != "" {
reqHeaders . Set ( "If-None-Match" , c . ifNoneMatch_ )
}
var body io . Reader = nil
c . urlParams_ . Set ( "alt" , alt )
2019-03-17 20:19:56 +01:00
c . urlParams_ . Set ( "prettyPrint" , "false" )
2018-06-19 15:30:26 +02:00
urls := googleapi . ResolveRelative ( c . s . BasePath , "activities" )
urls += "?" + c . urlParams_ . Encode ( )
2019-03-17 20:19:56 +01:00
req , err := http . NewRequest ( "GET" , urls , body )
if err != nil {
return nil , err
}
2018-06-19 15:30:26 +02:00
req . Header = reqHeaders
return gensupport . SendRequest ( c . ctx_ , c . s . client , req )
}
// Do executes the "appsactivity.activities.list" call.
// Exactly one of *ListActivitiesResponse or error will be non-nil. Any
// non-2xx status code is an error. Response headers are in either
// *ListActivitiesResponse.ServerResponse.Header or (if a response was
// returned at all) in error.(*googleapi.Error).Header. Use
// googleapi.IsNotModified to check whether the returned error was
// because http.StatusNotModified was returned.
func ( c * ActivitiesListCall ) Do ( opts ... googleapi . CallOption ) ( * ListActivitiesResponse , error ) {
gensupport . SetOptions ( c . urlParams_ , opts ... )
res , err := c . doRequest ( "json" )
if res != nil && res . StatusCode == http . StatusNotModified {
if res . Body != nil {
res . Body . Close ( )
}
return nil , & googleapi . Error {
Code : res . StatusCode ,
Header : res . Header ,
}
}
if err != nil {
return nil , err
}
defer googleapi . CloseBody ( res )
if err := googleapi . CheckResponse ( res ) ; err != nil {
return nil , err
}
ret := & ListActivitiesResponse {
ServerResponse : googleapi . ServerResponse {
Header : res . Header ,
HTTPStatusCode : res . StatusCode ,
} ,
}
target := & ret
if err := gensupport . DecodeResponse ( target , res ) ; err != nil {
return nil , err
}
return ret , nil
// {
// "description": "Returns a list of activities visible to the current logged in user. Visible activities are determined by the visiblity settings of the object that was acted on, e.g. Drive files a user can see. An activity is a record of past events. Multiple events may be merged if they are similar. A request is scoped to activities from a given Google service using the source parameter.",
// "httpMethod": "GET",
// "id": "appsactivity.activities.list",
// "parameters": {
// "drive.ancestorId": {
// "description": "Identifies the Drive folder containing the items for which to return activities.",
// "location": "query",
// "type": "string"
// },
// "drive.fileId": {
// "description": "Identifies the Drive item to return activities for.",
// "location": "query",
// "type": "string"
// },
// "groupingStrategy": {
// "default": "driveUi",
// "description": "Indicates the strategy to use when grouping singleEvents items in the associated combinedEvent object.",
// "enum": [
// "driveUi",
// "none"
// ],
// "enumDescriptions": [
// "",
// ""
// ],
// "location": "query",
// "type": "string"
// },
// "pageSize": {
// "default": "50",
// "description": "The maximum number of events to return on a page. The response includes a continuation token if there are more events.",
// "format": "int32",
// "location": "query",
// "type": "integer"
// },
// "pageToken": {
// "description": "A token to retrieve a specific page of results.",
// "location": "query",
// "type": "string"
// },
// "source": {
// "description": "The Google service from which to return activities. Possible values of source are: \n- drive.google.com",
// "location": "query",
// "type": "string"
// },
// "userId": {
// "default": "me",
// "description": "Indicates the user to return activity for. Use the special value me to indicate the currently authenticated user.",
// "location": "query",
// "type": "string"
// }
// },
// "path": "activities",
// "response": {
// "$ref": "ListActivitiesResponse"
// },
// "scopes": [
// "https://www.googleapis.com/auth/activity"
// ]
// }
}
// Pages invokes f for each page of results.
// A non-nil error returned from f will halt the iteration.
// The provided context supersedes any context provided to the Context method.
func ( c * ActivitiesListCall ) Pages ( ctx context . Context , f func ( * ListActivitiesResponse ) error ) error {
c . ctx_ = ctx
defer c . PageToken ( c . urlParams_ . Get ( "pageToken" ) ) // reset paging to original point
for {
x , err := c . Do ( )
if err != nil {
return err
}
if err := f ( x ) ; err != nil {
return err
}
if x . NextPageToken == "" {
return nil
}
c . PageToken ( x . NextPageToken )
}
}