drive

package
v0.193.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 20, 2024 License: BSD-3-Clause Imports: 16 Imported by: 751

Documentation

Overview

Package drive provides access to the Google Drive API.

For product documentation, see: https://developers.google.com/drive/

Library status

These client libraries are officially supported by Google. However, this library is considered complete and is in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.

When possible, we recommend using our newer [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) that are still actively being worked and iterated on.

Creating a client

Usage example:

import "google.golang.org/api/drive/v3"
...
ctx := context.Background()
driveService, err := drive.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

By default, all available scopes (see "Constants") are used to authenticate. To restrict scopes, use google.golang.org/api/option.WithScopes:

driveService, err := drive.NewService(ctx, option.WithScopes(drive.DriveScriptsScope))

To use an API key for authentication (note: some APIs do not support API keys), use google.golang.org/api/option.WithAPIKey:

driveService, err := drive.NewService(ctx, option.WithAPIKey("AIza..."))

To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow, use google.golang.org/api/option.WithTokenSource:

config := &oauth2.Config{...}
// ...
token, err := config.Exchange(ctx, ...)
driveService, err := drive.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

See google.golang.org/api/option.ClientOption for details on options.

Index

Constants

View Source
const (
	// See, edit, create, and delete all of your Google Drive files
	DriveScope = "https://www.googleapis.com/auth/drive"

	// See, create, and delete its own configuration data in your Google Drive
	DriveAppdataScope = "https://www.googleapis.com/auth/drive.appdata"

	// View your Google Drive apps
	DriveAppsReadonlyScope = "https://www.googleapis.com/auth/drive.apps.readonly"

	// See, edit, create, and delete only the specific Google Drive files you use
	// with this app
	DriveFileScope = "https://www.googleapis.com/auth/drive.file"

	// See and download your Google Drive files that were created or edited by
	// Google Meet.
	DriveMeetReadonlyScope = "https://www.googleapis.com/auth/drive.meet.readonly"

	// View and manage metadata of files in your Google Drive
	DriveMetadataScope = "https://www.googleapis.com/auth/drive.metadata"

	// See information about your Google Drive files
	DriveMetadataReadonlyScope = "https://www.googleapis.com/auth/drive.metadata.readonly"

	// View the photos, videos and albums in your Google Photos
	DrivePhotosReadonlyScope = "https://www.googleapis.com/auth/drive.photos.readonly"

	// See and download all your Google Drive files
	DriveReadonlyScope = "https://www.googleapis.com/auth/drive.readonly"

	// Modify your Google Apps Script scripts' behavior
	DriveScriptsScope = "https://www.googleapis.com/auth/drive.scripts"
)

OAuth2 scopes used by this API.

Variables

This section is empty.

Functions

This section is empty.

Types

type About

type About struct {
	// AppInstalled: Whether the user has installed the requesting app.
	AppInstalled bool `json:"appInstalled,omitempty"`
	// CanCreateDrives: Whether the user can create shared drives.
	CanCreateDrives bool `json:"canCreateDrives,omitempty"`
	// CanCreateTeamDrives: Deprecated: Use `canCreateDrives` instead.
	CanCreateTeamDrives bool `json:"canCreateTeamDrives,omitempty"`
	// DriveThemes: A list of themes that are supported for shared drives.
	DriveThemes []*AboutDriveThemes `json:"driveThemes,omitempty"`
	// ExportFormats: A map of source MIME type to possible targets for all
	// supported exports.
	ExportFormats map[string][]string `json:"exportFormats,omitempty"`
	// FolderColorPalette: The currently supported folder colors as RGB hex
	// strings.
	FolderColorPalette []string `json:"folderColorPalette,omitempty"`
	// ImportFormats: A map of source MIME type to possible targets for all
	// supported imports.
	ImportFormats map[string][]string `json:"importFormats,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#about".
	Kind string `json:"kind,omitempty"`
	// MaxImportSizes: A map of maximum import sizes by MIME type, in bytes.
	MaxImportSizes map[string]string `json:"maxImportSizes,omitempty"`
	// MaxUploadSize: The maximum upload size in bytes.
	MaxUploadSize int64 `json:"maxUploadSize,omitempty,string"`
	// StorageQuota: The user's storage quota limits and usage. For users that are
	// part of an organization with pooled storage, information about the limit and
	// usage across all services is for the organization, rather than the
	// individual user. All fields are measured in bytes.
	StorageQuota *AboutStorageQuota `json:"storageQuota,omitempty"`
	// TeamDriveThemes: Deprecated: Use `driveThemes` instead.
	TeamDriveThemes []*AboutTeamDriveThemes `json:"teamDriveThemes,omitempty"`
	// User: The authenticated user.
	User *User `json:"user,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AppInstalled") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AppInstalled") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

About: Information about the user, the user's Drive, and system capabilities.

func (About) MarshalJSON

func (s About) MarshalJSON() ([]byte, error)

type AboutDriveThemes added in v0.4.0

type AboutDriveThemes struct {
	// BackgroundImageLink: A link to this theme's background image.
	BackgroundImageLink string `json:"backgroundImageLink,omitempty"`
	// ColorRgb: The color of this theme as an RGB hex string.
	ColorRgb string `json:"colorRgb,omitempty"`
	// Id: The ID of the theme.
	Id string `json:"id,omitempty"`
	// ForceSendFields is a list of field names (e.g. "BackgroundImageLink") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BackgroundImageLink") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (AboutDriveThemes) MarshalJSON added in v0.4.0

func (s AboutDriveThemes) MarshalJSON() ([]byte, error)

type AboutGetCall

type AboutGetCall struct {
	// contains filtered or unexported fields
}

func (*AboutGetCall) Context

func (c *AboutGetCall) Context(ctx context.Context) *AboutGetCall

Context sets the context to be used in this call's Do method.

func (*AboutGetCall) Do

func (c *AboutGetCall) Do(opts ...googleapi.CallOption) (*About, error)

Do executes the "drive.about.get" call. Any non-2xx status code is an error. Response headers are in either *About.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 (*AboutGetCall) Fields

func (c *AboutGetCall) Fields(s ...googleapi.Field) *AboutGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AboutGetCall) Header

func (c *AboutGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AboutGetCall) IfNoneMatch

func (c *AboutGetCall) IfNoneMatch(entityTag string) *AboutGetCall

IfNoneMatch sets an 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.

type AboutService

type AboutService struct {
	// contains filtered or unexported fields
}

func NewAboutService

func NewAboutService(s *Service) *AboutService

func (*AboutService) Get

func (r *AboutService) Get() *AboutGetCall

Get: Gets information about the user, the user's Drive, and system capabilities.

type AboutStorageQuota

type AboutStorageQuota struct {
	// Limit: The usage limit, if applicable. This will not be present if the user
	// has unlimited storage. For users that are part of an organization with
	// pooled storage, this is the limit for the organization, rather than the
	// individual user.
	Limit int64 `json:"limit,omitempty,string"`
	// Usage: The total usage across all services. For users that are part of an
	// organization with pooled storage, this is the usage across all services for
	// the organization, rather than the individual user.
	Usage int64 `json:"usage,omitempty,string"`
	// UsageInDrive: The usage by all files in Google Drive.
	UsageInDrive int64 `json:"usageInDrive,omitempty,string"`
	// UsageInDriveTrash: The usage by trashed files in Google Drive.
	UsageInDriveTrash int64 `json:"usageInDriveTrash,omitempty,string"`
	// ForceSendFields is a list of field names (e.g. "Limit") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Limit") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

AboutStorageQuota: The user's storage quota limits and usage. For users that are part of an organization with pooled storage, information about the limit and usage across all services is for the organization, rather than the individual user. All fields are measured in bytes.

func (AboutStorageQuota) MarshalJSON

func (s AboutStorageQuota) MarshalJSON() ([]byte, error)

type AboutTeamDriveThemes

type AboutTeamDriveThemes struct {
	// BackgroundImageLink: Deprecated: Use `driveThemes/backgroundImageLink`
	// instead.
	BackgroundImageLink string `json:"backgroundImageLink,omitempty"`
	// ColorRgb: Deprecated: Use `driveThemes/colorRgb` instead.
	ColorRgb string `json:"colorRgb,omitempty"`
	// Id: Deprecated: Use `driveThemes/id` instead.
	Id string `json:"id,omitempty"`
	// ForceSendFields is a list of field names (e.g. "BackgroundImageLink") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BackgroundImageLink") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (AboutTeamDriveThemes) MarshalJSON

func (s AboutTeamDriveThemes) MarshalJSON() ([]byte, error)

type App added in v0.159.0

type App struct {
	// Authorized: Whether the app is authorized to access data on the user's
	// Drive.
	Authorized bool `json:"authorized,omitempty"`
	// CreateInFolderTemplate: The template URL to create a file with this app in a
	// given folder. The template contains the {folderId} to be replaced by the
	// folder ID house the new file.
	CreateInFolderTemplate string `json:"createInFolderTemplate,omitempty"`
	// CreateUrl: The URL to create a file with this app.
	CreateUrl string `json:"createUrl,omitempty"`
	// HasDriveWideScope: Whether the app has Drive-wide scope. An app with
	// Drive-wide scope can access all files in the user's Drive.
	HasDriveWideScope bool `json:"hasDriveWideScope,omitempty"`
	// Icons: The various icons for the app.
	Icons []*AppIcons `json:"icons,omitempty"`
	// Id: The ID of the app.
	Id string `json:"id,omitempty"`
	// Installed: Whether the app is installed.
	Installed bool `json:"installed,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#app".
	Kind string `json:"kind,omitempty"`
	// LongDescription: A long description of the app.
	LongDescription string `json:"longDescription,omitempty"`
	// Name: The name of the app.
	Name string `json:"name,omitempty"`
	// ObjectType: The type of object this app creates such as a Chart. If empty,
	// the app name should be used instead.
	ObjectType string `json:"objectType,omitempty"`
	// OpenUrlTemplate: The template URL for opening files with this app. The
	// template contains {ids} or {exportIds} to be replaced by the actual file
	// IDs. For more information, see Open Files for the full documentation.
	OpenUrlTemplate string `json:"openUrlTemplate,omitempty"`
	// PrimaryFileExtensions: The list of primary file extensions.
	PrimaryFileExtensions []string `json:"primaryFileExtensions,omitempty"`
	// PrimaryMimeTypes: The list of primary MIME types.
	PrimaryMimeTypes []string `json:"primaryMimeTypes,omitempty"`
	// ProductId: The ID of the product listing for this app.
	ProductId string `json:"productId,omitempty"`
	// ProductUrl: A link to the product listing for this app.
	ProductUrl string `json:"productUrl,omitempty"`
	// SecondaryFileExtensions: The list of secondary file extensions.
	SecondaryFileExtensions []string `json:"secondaryFileExtensions,omitempty"`
	// SecondaryMimeTypes: The list of secondary MIME types.
	SecondaryMimeTypes []string `json:"secondaryMimeTypes,omitempty"`
	// ShortDescription: A short description of the app.
	ShortDescription string `json:"shortDescription,omitempty"`
	// SupportsCreate: Whether this app supports creating objects.
	SupportsCreate bool `json:"supportsCreate,omitempty"`
	// SupportsImport: Whether this app supports importing from Google Docs.
	SupportsImport bool `json:"supportsImport,omitempty"`
	// SupportsMultiOpen: Whether this app supports opening more than one file.
	SupportsMultiOpen bool `json:"supportsMultiOpen,omitempty"`
	// SupportsOfflineCreate: Whether this app supports creating files when
	// offline.
	SupportsOfflineCreate bool `json:"supportsOfflineCreate,omitempty"`
	// UseByDefault: Whether the app is selected as the default handler for the
	// types it supports.
	UseByDefault bool `json:"useByDefault,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Authorized") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Authorized") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

App: The `apps` resource provides a list of apps that a user has installed, with information about each app's supported MIME types, file extensions, and other details. Some resource methods (such as `apps.get`) require an `appId`. Use the `apps.list` method to retrieve the ID for an installed application.

func (App) MarshalJSON added in v0.159.0

func (s App) MarshalJSON() ([]byte, error)

type AppIcons added in v0.159.0

type AppIcons struct {
	// Category: Category of the icon. Allowed values are: * `application` - The
	// icon for the application. * `document` - The icon for a file associated with
	// the app. * `documentShared` - The icon for a shared file associated with the
	// app.
	Category string `json:"category,omitempty"`
	// IconUrl: URL for the icon.
	IconUrl string `json:"iconUrl,omitempty"`
	// Size: Size of the icon. Represented as the maximum of the width and height.
	Size int64 `json:"size,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Category") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Category") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (AppIcons) MarshalJSON added in v0.159.0

func (s AppIcons) MarshalJSON() ([]byte, error)

type AppList added in v0.159.0

type AppList struct {
	// DefaultAppIds: The list of app IDs that the user has specified to use by
	// default. The list is in reverse-priority order (lowest to highest).
	DefaultAppIds []string `json:"defaultAppIds,omitempty"`
	// Items: The list of apps.
	Items []*App `json:"items,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#appList".
	Kind string `json:"kind,omitempty"`
	// SelfLink: A link back to this list.
	SelfLink string `json:"selfLink,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "DefaultAppIds") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DefaultAppIds") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

AppList: A list of third-party applications which the user has installed or given access to Google Drive.

func (AppList) MarshalJSON added in v0.159.0

func (s AppList) MarshalJSON() ([]byte, error)

type AppsGetCall added in v0.159.0

type AppsGetCall struct {
	// contains filtered or unexported fields
}

func (*AppsGetCall) Context added in v0.159.0

func (c *AppsGetCall) Context(ctx context.Context) *AppsGetCall

Context sets the context to be used in this call's Do method.

func (*AppsGetCall) Do added in v0.159.0

func (c *AppsGetCall) Do(opts ...googleapi.CallOption) (*App, error)

Do executes the "drive.apps.get" call. Any non-2xx status code is an error. Response headers are in either *App.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 (*AppsGetCall) Fields added in v0.159.0

func (c *AppsGetCall) Fields(s ...googleapi.Field) *AppsGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AppsGetCall) Header added in v0.159.0

func (c *AppsGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AppsGetCall) IfNoneMatch added in v0.159.0

func (c *AppsGetCall) IfNoneMatch(entityTag string) *AppsGetCall

IfNoneMatch sets an 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.

type AppsListCall added in v0.159.0

type AppsListCall struct {
	// contains filtered or unexported fields
}

func (*AppsListCall) AppFilterExtensions added in v0.159.0

func (c *AppsListCall) AppFilterExtensions(appFilterExtensions string) *AppsListCall

AppFilterExtensions sets the optional parameter "appFilterExtensions": A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given file extensions are included in the response. If `appFilterMimeTypes` are provided as well, the result is a union of the two resulting app lists.

func (*AppsListCall) AppFilterMimeTypes added in v0.159.0

func (c *AppsListCall) AppFilterMimeTypes(appFilterMimeTypes string) *AppsListCall

AppFilterMimeTypes sets the optional parameter "appFilterMimeTypes": A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given MIME types will be included in the response. If `appFilterExtensions` are provided as well, the result is a union of the two resulting app lists.

func (*AppsListCall) Context added in v0.159.0

func (c *AppsListCall) Context(ctx context.Context) *AppsListCall

Context sets the context to be used in this call's Do method.

func (*AppsListCall) Do added in v0.159.0

func (c *AppsListCall) Do(opts ...googleapi.CallOption) (*AppList, error)

Do executes the "drive.apps.list" call. Any non-2xx status code is an error. Response headers are in either *AppList.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 (*AppsListCall) Fields added in v0.159.0

func (c *AppsListCall) Fields(s ...googleapi.Field) *AppsListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*AppsListCall) Header added in v0.159.0

func (c *AppsListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*AppsListCall) IfNoneMatch added in v0.159.0

func (c *AppsListCall) IfNoneMatch(entityTag string) *AppsListCall

IfNoneMatch sets an 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.

func (*AppsListCall) LanguageCode added in v0.159.0

func (c *AppsListCall) LanguageCode(languageCode string) *AppsListCall

LanguageCode sets the optional parameter "languageCode": A language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format (http://www.unicode.org/reports/tr35/).

type AppsService added in v0.159.0

type AppsService struct {
	// contains filtered or unexported fields
}

func NewAppsService added in v0.159.0

func NewAppsService(s *Service) *AppsService

func (*AppsService) Get added in v0.159.0

func (r *AppsService) Get(appId string) *AppsGetCall

Get: Gets a specific app.

- appId: The ID of the app.

func (*AppsService) List added in v0.159.0

func (r *AppsService) List() *AppsListCall

List: Lists a user's installed apps.

type Change

type Change struct {
	// ChangeType: The type of the change. Possible values are `file` and `drive`.
	ChangeType string `json:"changeType,omitempty"`
	// Drive: The updated state of the shared drive. Present if the changeType is
	// drive, the user is still a member of the shared drive, and the shared drive
	// has not been deleted.
	Drive *Drive `json:"drive,omitempty"`
	// DriveId: The ID of the shared drive associated with this change.
	DriveId string `json:"driveId,omitempty"`
	// File: The updated state of the file. Present if the type is file and the
	// file has not been removed from this list of changes.
	File *File `json:"file,omitempty"`
	// FileId: The ID of the file which has changed.
	FileId string `json:"fileId,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#change".
	Kind string `json:"kind,omitempty"`
	// Removed: Whether the file or shared drive has been removed from this list of
	// changes, for example by deletion or loss of access.
	Removed bool `json:"removed,omitempty"`
	// TeamDrive: Deprecated: Use `drive` instead.
	TeamDrive *TeamDrive `json:"teamDrive,omitempty"`
	// TeamDriveId: Deprecated: Use `driveId` instead.
	TeamDriveId string `json:"teamDriveId,omitempty"`
	// Time: The time of this change (RFC 3339 date-time).
	Time string `json:"time,omitempty"`
	// Type: Deprecated: Use `changeType` instead.
	Type string `json:"type,omitempty"`
	// ForceSendFields is a list of field names (e.g. "ChangeType") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ChangeType") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Change: A change to a file or shared drive.

func (Change) MarshalJSON

func (s Change) MarshalJSON() ([]byte, error)

type ChangeList

type ChangeList struct {
	// Changes: The list of changes. If nextPageToken is populated, then this list
	// may be incomplete and an additional page of results should be fetched.
	Changes []*Change `json:"changes,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#changeList".
	Kind string `json:"kind,omitempty"`
	// NewStartPageToken: The starting page token for future changes. This will be
	// present only if the end of the current changes list has been reached. The
	// page token doesn't expire.
	NewStartPageToken string `json:"newStartPageToken,omitempty"`
	// NextPageToken: The page token for the next page of changes. This will be
	// absent if the end of the changes list has been reached. The page token
	// doesn't expire.
	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. "Changes") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Changes") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ChangeList: A list of changes for a user.

func (ChangeList) MarshalJSON

func (s ChangeList) MarshalJSON() ([]byte, error)

type ChangesGetStartPageTokenCall

type ChangesGetStartPageTokenCall struct {
	// contains filtered or unexported fields
}

func (*ChangesGetStartPageTokenCall) Context

Context sets the context to be used in this call's Do method.

func (*ChangesGetStartPageTokenCall) Do

Do executes the "drive.changes.getStartPageToken" call. Any non-2xx status code is an error. Response headers are in either *StartPageToken.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 (*ChangesGetStartPageTokenCall) DriveId added in v0.4.0

DriveId sets the optional parameter "driveId": The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned.

func (*ChangesGetStartPageTokenCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ChangesGetStartPageTokenCall) Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*ChangesGetStartPageTokenCall) IfNoneMatch

IfNoneMatch sets an 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.

func (*ChangesGetStartPageTokenCall) SupportsAllDrives added in v0.4.0

func (c *ChangesGetStartPageTokenCall) SupportsAllDrives(supportsAllDrives bool) *ChangesGetStartPageTokenCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*ChangesGetStartPageTokenCall) SupportsTeamDrives

func (c *ChangesGetStartPageTokenCall) SupportsTeamDrives(supportsTeamDrives bool) *ChangesGetStartPageTokenCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*ChangesGetStartPageTokenCall) TeamDriveId

TeamDriveId sets the optional parameter "teamDriveId": Deprecated: Use `driveId` instead.

type ChangesListCall

type ChangesListCall struct {
	// contains filtered or unexported fields
}

func (*ChangesListCall) Context

Context sets the context to be used in this call's Do method.

func (*ChangesListCall) Do

Do executes the "drive.changes.list" call. Any non-2xx status code is an error. Response headers are in either *ChangeList.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 (*ChangesListCall) DriveId added in v0.4.0

func (c *ChangesListCall) DriveId(driveId string) *ChangesListCall

DriveId sets the optional parameter "driveId": The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier.

func (*ChangesListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ChangesListCall) Header

func (c *ChangesListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*ChangesListCall) IfNoneMatch

func (c *ChangesListCall) IfNoneMatch(entityTag string) *ChangesListCall

IfNoneMatch sets an 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.

func (*ChangesListCall) IncludeCorpusRemovals

func (c *ChangesListCall) IncludeCorpusRemovals(includeCorpusRemovals bool) *ChangesListCall

IncludeCorpusRemovals sets the optional parameter "includeCorpusRemovals": Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file.

func (*ChangesListCall) IncludeItemsFromAllDrives added in v0.4.0

func (c *ChangesListCall) IncludeItemsFromAllDrives(includeItemsFromAllDrives bool) *ChangesListCall

IncludeItemsFromAllDrives sets the optional parameter "includeItemsFromAllDrives": Whether both My Drive and shared drive items should be included in results.

func (*ChangesListCall) IncludeLabels added in v0.88.0

func (c *ChangesListCall) IncludeLabels(includeLabels string) *ChangesListCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*ChangesListCall) IncludePermissionsForView added in v0.31.0

func (c *ChangesListCall) IncludePermissionsForView(includePermissionsForView string) *ChangesListCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*ChangesListCall) IncludeRemoved

func (c *ChangesListCall) IncludeRemoved(includeRemoved bool) *ChangesListCall

IncludeRemoved sets the optional parameter "includeRemoved": Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.

func (*ChangesListCall) IncludeTeamDriveItems

func (c *ChangesListCall) IncludeTeamDriveItems(includeTeamDriveItems bool) *ChangesListCall

IncludeTeamDriveItems sets the optional parameter "includeTeamDriveItems": Deprecated: Use `includeItemsFromAllDrives` instead.

func (*ChangesListCall) PageSize

func (c *ChangesListCall) PageSize(pageSize int64) *ChangesListCall

PageSize sets the optional parameter "pageSize": The maximum number of changes to return per page.

func (*ChangesListCall) RestrictToMyDrive

func (c *ChangesListCall) RestrictToMyDrive(restrictToMyDrive bool) *ChangesListCall

RestrictToMyDrive sets the optional parameter "restrictToMyDrive": Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.

func (*ChangesListCall) Spaces

func (c *ChangesListCall) Spaces(spaces string) *ChangesListCall

Spaces sets the optional parameter "spaces": A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.

func (*ChangesListCall) SupportsAllDrives added in v0.4.0

func (c *ChangesListCall) SupportsAllDrives(supportsAllDrives bool) *ChangesListCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*ChangesListCall) SupportsTeamDrives

func (c *ChangesListCall) SupportsTeamDrives(supportsTeamDrives bool) *ChangesListCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*ChangesListCall) TeamDriveId

func (c *ChangesListCall) TeamDriveId(teamDriveId string) *ChangesListCall

TeamDriveId sets the optional parameter "teamDriveId": Deprecated: Use `driveId` instead.

type ChangesService

type ChangesService struct {
	// contains filtered or unexported fields
}

func NewChangesService

func NewChangesService(s *Service) *ChangesService

func (*ChangesService) GetStartPageToken

func (r *ChangesService) GetStartPageToken() *ChangesGetStartPageTokenCall

GetStartPageToken: Gets the starting pageToken for listing future changes.

func (*ChangesService) List

func (r *ChangesService) List(pageToken string) *ChangesListCall

List: Lists the changes for a user or shared drive.

  • pageToken: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.

func (*ChangesService) Watch

func (r *ChangesService) Watch(pageToken string, channel *Channel) *ChangesWatchCall

Watch: Subscribes to changes for a user.

  • pageToken: The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.

type ChangesWatchCall

type ChangesWatchCall struct {
	// contains filtered or unexported fields
}

func (*ChangesWatchCall) Context

Context sets the context to be used in this call's Do method.

func (*ChangesWatchCall) Do

func (c *ChangesWatchCall) Do(opts ...googleapi.CallOption) (*Channel, error)

Do executes the "drive.changes.watch" call. Any non-2xx status code is an error. Response headers are in either *Channel.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 (*ChangesWatchCall) DriveId added in v0.4.0

func (c *ChangesWatchCall) DriveId(driveId string) *ChangesWatchCall

DriveId sets the optional parameter "driveId": The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier.

func (*ChangesWatchCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ChangesWatchCall) Header

func (c *ChangesWatchCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*ChangesWatchCall) IncludeCorpusRemovals

func (c *ChangesWatchCall) IncludeCorpusRemovals(includeCorpusRemovals bool) *ChangesWatchCall

IncludeCorpusRemovals sets the optional parameter "includeCorpusRemovals": Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file.

func (*ChangesWatchCall) IncludeItemsFromAllDrives added in v0.4.0

func (c *ChangesWatchCall) IncludeItemsFromAllDrives(includeItemsFromAllDrives bool) *ChangesWatchCall

IncludeItemsFromAllDrives sets the optional parameter "includeItemsFromAllDrives": Whether both My Drive and shared drive items should be included in results.

func (*ChangesWatchCall) IncludeLabels added in v0.88.0

func (c *ChangesWatchCall) IncludeLabels(includeLabels string) *ChangesWatchCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*ChangesWatchCall) IncludePermissionsForView added in v0.31.0

func (c *ChangesWatchCall) IncludePermissionsForView(includePermissionsForView string) *ChangesWatchCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*ChangesWatchCall) IncludeRemoved

func (c *ChangesWatchCall) IncludeRemoved(includeRemoved bool) *ChangesWatchCall

IncludeRemoved sets the optional parameter "includeRemoved": Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.

func (*ChangesWatchCall) IncludeTeamDriveItems

func (c *ChangesWatchCall) IncludeTeamDriveItems(includeTeamDriveItems bool) *ChangesWatchCall

IncludeTeamDriveItems sets the optional parameter "includeTeamDriveItems": Deprecated: Use `includeItemsFromAllDrives` instead.

func (*ChangesWatchCall) PageSize

func (c *ChangesWatchCall) PageSize(pageSize int64) *ChangesWatchCall

PageSize sets the optional parameter "pageSize": The maximum number of changes to return per page.

func (*ChangesWatchCall) RestrictToMyDrive

func (c *ChangesWatchCall) RestrictToMyDrive(restrictToMyDrive bool) *ChangesWatchCall

RestrictToMyDrive sets the optional parameter "restrictToMyDrive": Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.

func (*ChangesWatchCall) Spaces

func (c *ChangesWatchCall) Spaces(spaces string) *ChangesWatchCall

Spaces sets the optional parameter "spaces": A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.

func (*ChangesWatchCall) SupportsAllDrives added in v0.4.0

func (c *ChangesWatchCall) SupportsAllDrives(supportsAllDrives bool) *ChangesWatchCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*ChangesWatchCall) SupportsTeamDrives

func (c *ChangesWatchCall) SupportsTeamDrives(supportsTeamDrives bool) *ChangesWatchCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*ChangesWatchCall) TeamDriveId

func (c *ChangesWatchCall) TeamDriveId(teamDriveId string) *ChangesWatchCall

TeamDriveId sets the optional parameter "teamDriveId": Deprecated: Use `driveId` instead.

type Channel

type Channel struct {
	// Address: The address where notifications are delivered for this channel.
	Address string `json:"address,omitempty"`
	// Expiration: Date and time of notification channel expiration, expressed as a
	// Unix timestamp, in milliseconds. Optional.
	Expiration int64 `json:"expiration,omitempty,string"`
	// Id: A UUID or similar unique string that identifies this channel.
	Id string `json:"id,omitempty"`
	// Kind: Identifies this as a notification channel used to watch for changes to
	// a resource, which is `api#channel`.
	Kind string `json:"kind,omitempty"`
	// Params: Additional parameters controlling delivery channel behavior.
	// Optional.
	Params map[string]string `json:"params,omitempty"`
	// Payload: A Boolean value to indicate whether payload is wanted. Optional.
	Payload bool `json:"payload,omitempty"`
	// ResourceId: An opaque ID that identifies the resource being watched on this
	// channel. Stable across different API versions.
	ResourceId string `json:"resourceId,omitempty"`
	// ResourceUri: A version-specific identifier for the watched resource.
	ResourceUri string `json:"resourceUri,omitempty"`
	// Token: An arbitrary string delivered to the target address with each
	// notification delivered over this channel. Optional.
	Token string `json:"token,omitempty"`
	// Type: The type of delivery mechanism used for this channel. Valid values are
	// "web_hook" or "webhook".
	Type string `json:"type,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Address") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Address") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Channel: A notification channel used to watch for resource changes.

func (Channel) MarshalJSON

func (s Channel) MarshalJSON() ([]byte, error)

type ChannelsService

type ChannelsService struct {
	// contains filtered or unexported fields
}

func NewChannelsService

func NewChannelsService(s *Service) *ChannelsService

func (*ChannelsService) Stop

func (r *ChannelsService) Stop(channel *Channel) *ChannelsStopCall

Stop: Stops watching resources through this channel.

type ChannelsStopCall

type ChannelsStopCall struct {
	// contains filtered or unexported fields
}

func (*ChannelsStopCall) Context

Context sets the context to be used in this call's Do method.

func (*ChannelsStopCall) Do

func (c *ChannelsStopCall) Do(opts ...googleapi.CallOption) error

Do executes the "drive.channels.stop" call.

func (*ChannelsStopCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*ChannelsStopCall) Header

func (c *ChannelsStopCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type Comment

type Comment struct {
	// Anchor: A region of the document represented as a JSON string. For details
	// on defining anchor properties, refer to Manage comments and replies
	// (https://developers.google.com/drive/api/v3/manage-comments).
	Anchor string `json:"anchor,omitempty"`
	// Author: Output only. The author of the comment. The author's email address
	// and permission ID will not be populated.
	Author *User `json:"author,omitempty"`
	// Content: The plain text content of the comment. This field is used for
	// setting the content, while `htmlContent` should be displayed.
	Content string `json:"content,omitempty"`
	// CreatedTime: The time at which the comment was created (RFC 3339 date-time).
	CreatedTime string `json:"createdTime,omitempty"`
	// Deleted: Output only. Whether the comment has been deleted. A deleted
	// comment has no content.
	Deleted bool `json:"deleted,omitempty"`
	// HtmlContent: Output only. The content of the comment with HTML formatting.
	HtmlContent string `json:"htmlContent,omitempty"`
	// Id: Output only. The ID of the comment.
	Id string `json:"id,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#comment".
	Kind string `json:"kind,omitempty"`
	// ModifiedTime: The last time the comment or any of its replies was modified
	// (RFC 3339 date-time).
	ModifiedTime string `json:"modifiedTime,omitempty"`
	// QuotedFileContent: The file content to which the comment refers, typically
	// within the anchor region. For a text file, for example, this would be the
	// text at the location of the comment.
	QuotedFileContent *CommentQuotedFileContent `json:"quotedFileContent,omitempty"`
	// Replies: Output only. The full list of replies to the comment in
	// chronological order.
	Replies []*Reply `json:"replies,omitempty"`
	// Resolved: Output only. Whether the comment has been resolved by one of its
	// replies.
	Resolved bool `json:"resolved,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Anchor") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Anchor") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Comment: A comment on a file. Some resource methods (such as `comments.update`) require a `commentId`. Use the `comments.list` method to retrieve the ID for a comment in a file.

func (Comment) MarshalJSON

func (s Comment) MarshalJSON() ([]byte, error)

type CommentList

type CommentList struct {
	// Comments: The list of comments. If nextPageToken is populated, then this
	// list may be incomplete and an additional page of results should be fetched.
	Comments []*Comment `json:"comments,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#commentList".
	Kind string `json:"kind,omitempty"`
	// NextPageToken: The page token for the next page of comments. This will be
	// absent if the end of the comments list has been reached. If the token is
	// rejected for any reason, it should be discarded, and pagination should be
	// restarted from the first page of results. The page token is typically valid
	// for several hours. However, if new items are added or removed, your expected
	// results might differ.
	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. "Comments") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Comments") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

CommentList: A list of comments on a file.

func (CommentList) MarshalJSON

func (s CommentList) MarshalJSON() ([]byte, error)

type CommentQuotedFileContent

type CommentQuotedFileContent struct {
	// MimeType: The MIME type of the quoted content.
	MimeType string `json:"mimeType,omitempty"`
	// Value: The quoted content itself. This is interpreted as plain text if set
	// through the API.
	Value string `json:"value,omitempty"`
	// ForceSendFields is a list of field names (e.g. "MimeType") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "MimeType") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

CommentQuotedFileContent: The file content to which the comment refers, typically within the anchor region. For a text file, for example, this would be the text at the location of the comment.

func (CommentQuotedFileContent) MarshalJSON

func (s CommentQuotedFileContent) MarshalJSON() ([]byte, error)

type CommentsCreateCall

type CommentsCreateCall struct {
	// contains filtered or unexported fields
}

func (*CommentsCreateCall) Context

Context sets the context to be used in this call's Do method.

func (*CommentsCreateCall) Do

Do executes the "drive.comments.create" call. Any non-2xx status code is an error. Response headers are in either *Comment.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 (*CommentsCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*CommentsCreateCall) Header

func (c *CommentsCreateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type CommentsDeleteCall

type CommentsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*CommentsDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*CommentsDeleteCall) Do

Do executes the "drive.comments.delete" call.

func (*CommentsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*CommentsDeleteCall) Header

func (c *CommentsDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type CommentsGetCall

type CommentsGetCall struct {
	// contains filtered or unexported fields
}

func (*CommentsGetCall) Context

Context sets the context to be used in this call's Do method.

func (*CommentsGetCall) Do

func (c *CommentsGetCall) Do(opts ...googleapi.CallOption) (*Comment, error)

Do executes the "drive.comments.get" call. Any non-2xx status code is an error. Response headers are in either *Comment.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 (*CommentsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*CommentsGetCall) Header

func (c *CommentsGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*CommentsGetCall) IfNoneMatch

func (c *CommentsGetCall) IfNoneMatch(entityTag string) *CommentsGetCall

IfNoneMatch sets an 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.

func (*CommentsGetCall) IncludeDeleted

func (c *CommentsGetCall) IncludeDeleted(includeDeleted bool) *CommentsGetCall

IncludeDeleted sets the optional parameter "includeDeleted": Whether to return deleted comments. Deleted comments will not include their original content.

type CommentsListCall

type CommentsListCall struct {
	// contains filtered or unexported fields
}

func (*CommentsListCall) Context

Context sets the context to be used in this call's Do method.

func (*CommentsListCall) Do

Do executes the "drive.comments.list" call. Any non-2xx status code is an error. Response headers are in either *CommentList.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 (*CommentsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*CommentsListCall) Header

func (c *CommentsListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*CommentsListCall) IfNoneMatch

func (c *CommentsListCall) IfNoneMatch(entityTag string) *CommentsListCall

IfNoneMatch sets an 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.

func (*CommentsListCall) IncludeDeleted

func (c *CommentsListCall) IncludeDeleted(includeDeleted bool) *CommentsListCall

IncludeDeleted sets the optional parameter "includeDeleted": Whether to include deleted comments. Deleted comments will not include their original content.

func (*CommentsListCall) PageSize

func (c *CommentsListCall) PageSize(pageSize int64) *CommentsListCall

PageSize sets the optional parameter "pageSize": The maximum number of comments to return per page.

func (*CommentsListCall) PageToken

func (c *CommentsListCall) PageToken(pageToken string) *CommentsListCall

PageToken sets the optional parameter "pageToken": The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

func (*CommentsListCall) Pages

func (c *CommentsListCall) Pages(ctx context.Context, f func(*CommentList) error) error

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 (*CommentsListCall) StartModifiedTime

func (c *CommentsListCall) StartModifiedTime(startModifiedTime string) *CommentsListCall

StartModifiedTime sets the optional parameter "startModifiedTime": The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time).

type CommentsService

type CommentsService struct {
	// contains filtered or unexported fields
}

func NewCommentsService

func NewCommentsService(s *Service) *CommentsService

func (*CommentsService) Create

func (r *CommentsService) Create(fileId string, comment *Comment) *CommentsCreateCall

Create: Creates a comment on a file.

- fileId: The ID of the file.

func (*CommentsService) Delete

func (r *CommentsService) Delete(fileId string, commentId string) *CommentsDeleteCall

Delete: Deletes a comment.

- commentId: The ID of the comment. - fileId: The ID of the file.

func (*CommentsService) Get

func (r *CommentsService) Get(fileId string, commentId string) *CommentsGetCall

Get: Gets a comment by ID.

- commentId: The ID of the comment. - fileId: The ID of the file.

func (*CommentsService) List

func (r *CommentsService) List(fileId string) *CommentsListCall

List: Lists a file's comments.

- fileId: The ID of the file.

func (*CommentsService) Update

func (r *CommentsService) Update(fileId string, commentId string, comment *Comment) *CommentsUpdateCall

Update: Updates a comment with patch semantics.

- commentId: The ID of the comment. - fileId: The ID of the file.

type CommentsUpdateCall

type CommentsUpdateCall struct {
	// contains filtered or unexported fields
}

func (*CommentsUpdateCall) Context

Context sets the context to be used in this call's Do method.

func (*CommentsUpdateCall) Do

Do executes the "drive.comments.update" call. Any non-2xx status code is an error. Response headers are in either *Comment.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 (*CommentsUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*CommentsUpdateCall) Header

func (c *CommentsUpdateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type ContentRestriction added in v0.30.0

type ContentRestriction struct {
	// OwnerRestricted: Whether the content restriction can only be modified or
	// removed by a user who owns the file. For files in shared drives, any user
	// with `organizer` capabilities can modify or remove this content restriction.
	OwnerRestricted bool `json:"ownerRestricted,omitempty"`
	// ReadOnly: Whether the content of the file is read-only. If a file is
	// read-only, a new revision of the file may not be added, comments may not be
	// added or modified, and the title of the file may not be modified.
	ReadOnly bool `json:"readOnly,omitempty"`
	// Reason: Reason for why the content of the file is restricted. This is only
	// mutable on requests that also set `readOnly=true`.
	Reason string `json:"reason,omitempty"`
	// RestrictingUser: Output only. The user who set the content restriction. Only
	// populated if `readOnly` is true.
	RestrictingUser *User `json:"restrictingUser,omitempty"`
	// RestrictionTime: The time at which the content restriction was set
	// (formatted RFC 3339 timestamp). Only populated if readOnly is true.
	RestrictionTime string `json:"restrictionTime,omitempty"`
	// SystemRestricted: Output only. Whether the content restriction was applied
	// by the system, for example due to an esignature. Users cannot modify or
	// remove system restricted content restrictions.
	SystemRestricted bool `json:"systemRestricted,omitempty"`
	// Type: Output only. The type of the content restriction. Currently the only
	// possible value is `globalContentRestriction`.
	Type string `json:"type,omitempty"`
	// ForceSendFields is a list of field names (e.g. "OwnerRestricted") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "OwnerRestricted") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ContentRestriction: A restriction for accessing the content of the file.

func (ContentRestriction) MarshalJSON added in v0.30.0

func (s ContentRestriction) MarshalJSON() ([]byte, error)

type Drive added in v0.4.0

type Drive struct {
	// BackgroundImageFile: An image file and cropping parameters from which a
	// background image for this shared drive is set. This is a write only field;
	// it can only be set on `drive.drives.update` requests that don't set
	// `themeId`. When specified, all fields of the `backgroundImageFile` must be
	// set.
	BackgroundImageFile *DriveBackgroundImageFile `json:"backgroundImageFile,omitempty"`
	// BackgroundImageLink: Output only. A short-lived link to this shared drive's
	// background image.
	BackgroundImageLink string `json:"backgroundImageLink,omitempty"`
	// Capabilities: Output only. Capabilities the current user has on this shared
	// drive.
	Capabilities *DriveCapabilities `json:"capabilities,omitempty"`
	// ColorRgb: The color of this shared drive as an RGB hex string. It can only
	// be set on a `drive.drives.update` request that does not set `themeId`.
	ColorRgb string `json:"colorRgb,omitempty"`
	// CreatedTime: The time at which the shared drive was created (RFC 3339
	// date-time).
	CreatedTime string `json:"createdTime,omitempty"`
	// Hidden: Whether the shared drive is hidden from default view.
	Hidden bool `json:"hidden,omitempty"`
	// Id: Output only. The ID of this shared drive which is also the ID of the top
	// level folder of this shared drive.
	Id string `json:"id,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#drive".
	Kind string `json:"kind,omitempty"`
	// Name: The name of this shared drive.
	Name string `json:"name,omitempty"`
	// OrgUnitId: Output only. The organizational unit of this shared drive. This
	// field is only populated on `drives.list` responses when the
	// `useDomainAdminAccess` parameter is set to `true`.
	OrgUnitId string `json:"orgUnitId,omitempty"`
	// Restrictions: A set of restrictions that apply to this shared drive or items
	// inside this shared drive. Note that restrictions can't be set when creating
	// a shared drive. To add a restriction, first create a shared drive and then
	// use `drives.update` to add restrictions.
	Restrictions *DriveRestrictions `json:"restrictions,omitempty"`
	// ThemeId: The ID of the theme from which the background image and color will
	// be set. The set of possible `driveThemes` can be retrieved from a
	// `drive.about.get` response. When not specified on a `drive.drives.create`
	// request, a random theme is chosen from which the background image and color
	// are set. This is a write-only field; it can only be set on requests that
	// don't set `colorRgb` or `backgroundImageFile`.
	ThemeId string `json:"themeId,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "BackgroundImageFile") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BackgroundImageFile") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Drive: Representation of a shared drive. Some resource methods (such as `drives.update`) require a `driveId`. Use the `drives.list` method to retrieve the ID for a shared drive.

func (Drive) MarshalJSON added in v0.4.0

func (s Drive) MarshalJSON() ([]byte, error)

type DriveBackgroundImageFile added in v0.4.0

type DriveBackgroundImageFile struct {
	// Id: The ID of an image file in Google Drive to use for the background image.
	Id string `json:"id,omitempty"`
	// Width: The width of the cropped image in the closed range of 0 to 1. This
	// value represents the width of the cropped image divided by the width of the
	// entire image. The height is computed by applying a width to height aspect
	// ratio of 80 to 9. The resulting image must be at least 1280 pixels wide and
	// 144 pixels high.
	Width float64 `json:"width,omitempty"`
	// XCoordinate: The X coordinate of the upper left corner of the cropping area
	// in the background image. This is a value in the closed range of 0 to 1. This
	// value represents the horizontal distance from the left side of the entire
	// image to the left side of the cropping area divided by the width of the
	// entire image.
	XCoordinate float64 `json:"xCoordinate,omitempty"`
	// YCoordinate: The Y coordinate of the upper left corner of the cropping area
	// in the background image. This is a value in the closed range of 0 to 1. This
	// value represents the vertical distance from the top side of the entire image
	// to the top side of the cropping area divided by the height of the entire
	// image.
	YCoordinate float64 `json:"yCoordinate,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Id") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	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. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

DriveBackgroundImageFile: An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on `drive.drives.update` requests that don't set `themeId`. When specified, all fields of the `backgroundImageFile` must be set.

func (DriveBackgroundImageFile) MarshalJSON added in v0.4.0

func (s DriveBackgroundImageFile) MarshalJSON() ([]byte, error)

func (*DriveBackgroundImageFile) UnmarshalJSON added in v0.4.0

func (s *DriveBackgroundImageFile) UnmarshalJSON(data []byte) error

type DriveCapabilities added in v0.4.0

type DriveCapabilities struct {
	// CanAddChildren: Output only. Whether the current user can add children to
	// folders in this shared drive.
	CanAddChildren bool `json:"canAddChildren,omitempty"`
	// CanChangeCopyRequiresWriterPermissionRestriction: Output only. Whether the
	// current user can change the `copyRequiresWriterPermission` restriction of
	// this shared drive.
	CanChangeCopyRequiresWriterPermissionRestriction bool `json:"canChangeCopyRequiresWriterPermissionRestriction,omitempty"`
	// CanChangeDomainUsersOnlyRestriction: Output only. Whether the current user
	// can change the `domainUsersOnly` restriction of this shared drive.
	CanChangeDomainUsersOnlyRestriction bool `json:"canChangeDomainUsersOnlyRestriction,omitempty"`
	// CanChangeDriveBackground: Output only. Whether the current user can change
	// the background of this shared drive.
	CanChangeDriveBackground bool `json:"canChangeDriveBackground,omitempty"`
	// CanChangeDriveMembersOnlyRestriction: Output only. Whether the current user
	// can change the `driveMembersOnly` restriction of this shared drive.
	CanChangeDriveMembersOnlyRestriction bool `json:"canChangeDriveMembersOnlyRestriction,omitempty"`
	// CanChangeSharingFoldersRequiresOrganizerPermissionRestriction: Output only.
	// Whether the current user can change the
	// `sharingFoldersRequiresOrganizerPermission` restriction of this shared
	// drive.
	CanChangeSharingFoldersRequiresOrganizerPermissionRestriction bool `json:"canChangeSharingFoldersRequiresOrganizerPermissionRestriction,omitempty"`
	// CanComment: Output only. Whether the current user can comment on files in
	// this shared drive.
	CanComment bool `json:"canComment,omitempty"`
	// CanCopy: Output only. Whether the current user can copy files in this shared
	// drive.
	CanCopy bool `json:"canCopy,omitempty"`
	// CanDeleteChildren: Output only. Whether the current user can delete children
	// from folders in this shared drive.
	CanDeleteChildren bool `json:"canDeleteChildren,omitempty"`
	// CanDeleteDrive: Output only. Whether the current user can delete this shared
	// drive. Attempting to delete the shared drive may still fail if there are
	// untrashed items inside the shared drive.
	CanDeleteDrive bool `json:"canDeleteDrive,omitempty"`
	// CanDownload: Output only. Whether the current user can download files in
	// this shared drive.
	CanDownload bool `json:"canDownload,omitempty"`
	// CanEdit: Output only. Whether the current user can edit files in this shared
	// drive
	CanEdit bool `json:"canEdit,omitempty"`
	// CanListChildren: Output only. Whether the current user can list the children
	// of folders in this shared drive.
	CanListChildren bool `json:"canListChildren,omitempty"`
	// CanManageMembers: Output only. Whether the current user can add members to
	// this shared drive or remove them or change their role.
	CanManageMembers bool `json:"canManageMembers,omitempty"`
	// CanReadRevisions: Output only. Whether the current user can read the
	// revisions resource of files in this shared drive.
	CanReadRevisions bool `json:"canReadRevisions,omitempty"`
	// CanRename: Output only. Whether the current user can rename files or folders
	// in this shared drive.
	CanRename bool `json:"canRename,omitempty"`
	// CanRenameDrive: Output only. Whether the current user can rename this shared
	// drive.
	CanRenameDrive bool `json:"canRenameDrive,omitempty"`
	// CanResetDriveRestrictions: Output only. Whether the current user can reset
	// the shared drive restrictions to defaults.
	CanResetDriveRestrictions bool `json:"canResetDriveRestrictions,omitempty"`
	// CanShare: Output only. Whether the current user can share files or folders
	// in this shared drive.
	CanShare bool `json:"canShare,omitempty"`
	// CanTrashChildren: Output only. Whether the current user can trash children
	// from folders in this shared drive.
	CanTrashChildren bool `json:"canTrashChildren,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CanAddChildren") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CanAddChildren") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

DriveCapabilities: Output only. Capabilities the current user has on this shared drive.

func (DriveCapabilities) MarshalJSON added in v0.4.0

func (s DriveCapabilities) MarshalJSON() ([]byte, error)

type DriveList added in v0.4.0

type DriveList struct {
	// Drives: The list of shared drives. If nextPageToken is populated, then this
	// list may be incomplete and an additional page of results should be fetched.
	Drives []*Drive `json:"drives,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#driveList".
	Kind string `json:"kind,omitempty"`
	// NextPageToken: The page token for the next page of shared drives. This will
	// be absent if the end of the list has been reached. If the token is rejected
	// for any reason, it should be discarded, and pagination should be restarted
	// from the first page of results. The page token is typically valid for
	// several hours. However, if new items are added or removed, your expected
	// results might differ.
	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. "Drives") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Drives") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

DriveList: A list of shared drives.

func (DriveList) MarshalJSON added in v0.4.0

func (s DriveList) MarshalJSON() ([]byte, error)

type DriveRestrictions added in v0.4.0

type DriveRestrictions struct {
	// AdminManagedRestrictions: Whether administrative privileges on this shared
	// drive are required to modify restrictions.
	AdminManagedRestrictions bool `json:"adminManagedRestrictions,omitempty"`
	// CopyRequiresWriterPermission: Whether the options to copy, print, or
	// download files inside this shared drive, should be disabled for readers and
	// commenters. When this restriction is set to `true`, it will override the
	// similarly named field to `true` for any file inside this shared drive.
	CopyRequiresWriterPermission bool `json:"copyRequiresWriterPermission,omitempty"`
	// DomainUsersOnly: Whether access to this shared drive and items inside this
	// shared drive is restricted to users of the domain to which this shared drive
	// belongs. This restriction may be overridden by other sharing policies
	// controlled outside of this shared drive.
	DomainUsersOnly bool `json:"domainUsersOnly,omitempty"`
	// DriveMembersOnly: Whether access to items inside this shared drive is
	// restricted to its members.
	DriveMembersOnly bool `json:"driveMembersOnly,omitempty"`
	// SharingFoldersRequiresOrganizerPermission: If true, only users with the
	// organizer role can share folders. If false, users with either the organizer
	// role or the file organizer role can share folders.
	SharingFoldersRequiresOrganizerPermission bool `json:"sharingFoldersRequiresOrganizerPermission,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AdminManagedRestrictions")
	// to unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AdminManagedRestrictions") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

DriveRestrictions: A set of restrictions that apply to this shared drive or items inside this shared drive. Note that restrictions can't be set when creating a shared drive. To add a restriction, first create a shared drive and then use `drives.update` to add restrictions.

func (DriveRestrictions) MarshalJSON added in v0.4.0

func (s DriveRestrictions) MarshalJSON() ([]byte, error)

type DrivesCreateCall added in v0.4.0

type DrivesCreateCall struct {
	// contains filtered or unexported fields
}

func (*DrivesCreateCall) Context added in v0.4.0

Context sets the context to be used in this call's Do method.

func (*DrivesCreateCall) Do added in v0.4.0

func (c *DrivesCreateCall) Do(opts ...googleapi.CallOption) (*Drive, error)

Do executes the "drive.drives.create" call. Any non-2xx status code is an error. Response headers are in either *Drive.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 (*DrivesCreateCall) Fields added in v0.4.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*DrivesCreateCall) Header added in v0.4.0

func (c *DrivesCreateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type DrivesDeleteCall added in v0.4.0

type DrivesDeleteCall struct {
	// contains filtered or unexported fields
}

func (*DrivesDeleteCall) AllowItemDeletion added in v0.76.0

func (c *DrivesDeleteCall) AllowItemDeletion(allowItemDeletion bool) *DrivesDeleteCall

AllowItemDeletion sets the optional parameter "allowItemDeletion": Whether any items inside the shared drive should also be deleted. This option is only supported when `useDomainAdminAccess` is also set to `true`.

func (*DrivesDeleteCall) Context added in v0.4.0

Context sets the context to be used in this call's Do method.

func (*DrivesDeleteCall) Do added in v0.4.0

func (c *DrivesDeleteCall) Do(opts ...googleapi.CallOption) error

Do executes the "drive.drives.delete" call.

func (*DrivesDeleteCall) Fields added in v0.4.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*DrivesDeleteCall) Header added in v0.4.0

func (c *DrivesDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*DrivesDeleteCall) UseDomainAdminAccess added in v0.76.0

func (c *DrivesDeleteCall) UseDomainAdminAccess(useDomainAdminAccess bool) *DrivesDeleteCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.

type DrivesGetCall added in v0.4.0

type DrivesGetCall struct {
	// contains filtered or unexported fields
}

func (*DrivesGetCall) Context added in v0.4.0

func (c *DrivesGetCall) Context(ctx context.Context) *DrivesGetCall

Context sets the context to be used in this call's Do method.

func (*DrivesGetCall) Do added in v0.4.0

func (c *DrivesGetCall) Do(opts ...googleapi.CallOption) (*Drive, error)

Do executes the "drive.drives.get" call. Any non-2xx status code is an error. Response headers are in either *Drive.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 (*DrivesGetCall) Fields added in v0.4.0

func (c *DrivesGetCall) Fields(s ...googleapi.Field) *DrivesGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*DrivesGetCall) Header added in v0.4.0

func (c *DrivesGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*DrivesGetCall) IfNoneMatch added in v0.4.0

func (c *DrivesGetCall) IfNoneMatch(entityTag string) *DrivesGetCall

IfNoneMatch sets an 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.

func (*DrivesGetCall) UseDomainAdminAccess added in v0.4.0

func (c *DrivesGetCall) UseDomainAdminAccess(useDomainAdminAccess bool) *DrivesGetCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.

type DrivesHideCall added in v0.4.0

type DrivesHideCall struct {
	// contains filtered or unexported fields
}

func (*DrivesHideCall) Context added in v0.4.0

func (c *DrivesHideCall) Context(ctx context.Context) *DrivesHideCall

Context sets the context to be used in this call's Do method.

func (*DrivesHideCall) Do added in v0.4.0

func (c *DrivesHideCall) Do(opts ...googleapi.CallOption) (*Drive, error)

Do executes the "drive.drives.hide" call. Any non-2xx status code is an error. Response headers are in either *Drive.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 (*DrivesHideCall) Fields added in v0.4.0

func (c *DrivesHideCall) Fields(s ...googleapi.Field) *DrivesHideCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*DrivesHideCall) Header added in v0.4.0

func (c *DrivesHideCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type DrivesListCall added in v0.4.0

type DrivesListCall struct {
	// contains filtered or unexported fields
}

func (*DrivesListCall) Context added in v0.4.0

func (c *DrivesListCall) Context(ctx context.Context) *DrivesListCall

Context sets the context to be used in this call's Do method.

func (*DrivesListCall) Do added in v0.4.0

func (c *DrivesListCall) Do(opts ...googleapi.CallOption) (*DriveList, error)

Do executes the "drive.drives.list" call. Any non-2xx status code is an error. Response headers are in either *DriveList.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 (*DrivesListCall) Fields added in v0.4.0

func (c *DrivesListCall) Fields(s ...googleapi.Field) *DrivesListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*DrivesListCall) Header added in v0.4.0

func (c *DrivesListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*DrivesListCall) IfNoneMatch added in v0.4.0

func (c *DrivesListCall) IfNoneMatch(entityTag string) *DrivesListCall

IfNoneMatch sets an 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.

func (*DrivesListCall) PageSize added in v0.4.0

func (c *DrivesListCall) PageSize(pageSize int64) *DrivesListCall

PageSize sets the optional parameter "pageSize": Maximum number of shared drives to return per page.

func (*DrivesListCall) PageToken added in v0.4.0

func (c *DrivesListCall) PageToken(pageToken string) *DrivesListCall

PageToken sets the optional parameter "pageToken": Page token for shared drives.

func (*DrivesListCall) Pages added in v0.4.0

func (c *DrivesListCall) Pages(ctx context.Context, f func(*DriveList) error) error

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 (*DrivesListCall) Q added in v0.4.0

Q sets the optional parameter "q": Query string for searching shared drives.

func (*DrivesListCall) UseDomainAdminAccess added in v0.4.0

func (c *DrivesListCall) UseDomainAdminAccess(useDomainAdminAccess bool) *DrivesListCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then all shared drives of the domain in which the requester is an administrator are returned.

type DrivesService added in v0.4.0

type DrivesService struct {
	// contains filtered or unexported fields
}

func NewDrivesService added in v0.4.0

func NewDrivesService(s *Service) *DrivesService

func (*DrivesService) Create added in v0.4.0

func (r *DrivesService) Create(requestId string, drive *Drive) *DrivesCreateCall

Create: Creates a shared drive.

  • requestId: An ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a shared drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same shared drive. If the shared drive already exists a 409 error will be returned.

func (*DrivesService) Delete added in v0.4.0

func (r *DrivesService) Delete(driveId string) *DrivesDeleteCall

Delete: Permanently deletes a shared drive for which the user is an `organizer`. The shared drive cannot contain any untrashed items.

- driveId: The ID of the shared drive.

func (*DrivesService) Get added in v0.4.0

func (r *DrivesService) Get(driveId string) *DrivesGetCall

Get: Gets a shared drive's metadata by ID.

- driveId: The ID of the shared drive.

func (*DrivesService) Hide added in v0.4.0

func (r *DrivesService) Hide(driveId string) *DrivesHideCall

Hide: Hides a shared drive from the default view.

- driveId: The ID of the shared drive.

func (*DrivesService) List added in v0.4.0

func (r *DrivesService) List() *DrivesListCall

List: Lists the user's shared drives. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the Search for shared drives (/drive/api/guides/search-shareddrives) guide.

func (*DrivesService) Unhide added in v0.4.0

func (r *DrivesService) Unhide(driveId string) *DrivesUnhideCall

Unhide: Restores a shared drive to the default view.

- driveId: The ID of the shared drive.

func (*DrivesService) Update added in v0.4.0

func (r *DrivesService) Update(driveId string, drive *Drive) *DrivesUpdateCall

Update: Updates the metadata for a shared drive.

- driveId: The ID of the shared drive.

type DrivesUnhideCall added in v0.4.0

type DrivesUnhideCall struct {
	// contains filtered or unexported fields
}

func (*DrivesUnhideCall) Context added in v0.4.0

Context sets the context to be used in this call's Do method.

func (*DrivesUnhideCall) Do added in v0.4.0

func (c *DrivesUnhideCall) Do(opts ...googleapi.CallOption) (*Drive, error)

Do executes the "drive.drives.unhide" call. Any non-2xx status code is an error. Response headers are in either *Drive.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 (*DrivesUnhideCall) Fields added in v0.4.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*DrivesUnhideCall) Header added in v0.4.0

func (c *DrivesUnhideCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type DrivesUpdateCall added in v0.4.0

type DrivesUpdateCall struct {
	// contains filtered or unexported fields
}

func (*DrivesUpdateCall) Context added in v0.4.0

Context sets the context to be used in this call's Do method.

func (*DrivesUpdateCall) Do added in v0.4.0

func (c *DrivesUpdateCall) Do(opts ...googleapi.CallOption) (*Drive, error)

Do executes the "drive.drives.update" call. Any non-2xx status code is an error. Response headers are in either *Drive.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 (*DrivesUpdateCall) Fields added in v0.4.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*DrivesUpdateCall) Header added in v0.4.0

func (c *DrivesUpdateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*DrivesUpdateCall) UseDomainAdminAccess added in v0.4.0

func (c *DrivesUpdateCall) UseDomainAdminAccess(useDomainAdminAccess bool) *DrivesUpdateCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.

type File

type File struct {
	// AppProperties: A collection of arbitrary key-value pairs which are private
	// to the requesting app.
	// Entries with null values are cleared in update and copy requests. These
	// properties can only be retrieved using an authenticated request. An
	// authenticated request uses an access token obtained with a OAuth 2 client
	// ID. You cannot use an API key to retrieve private properties.
	AppProperties map[string]string `json:"appProperties,omitempty"`
	// Capabilities: Output only. Capabilities the current user has on this file.
	// Each capability corresponds to a fine-grained action that a user may take.
	Capabilities *FileCapabilities `json:"capabilities,omitempty"`
	// ContentHints: Additional information about the content of the file. These
	// fields are never populated in responses.
	ContentHints *FileContentHints `json:"contentHints,omitempty"`
	// ContentRestrictions: Restrictions for accessing the content of the file.
	// Only populated if such a restriction exists.
	ContentRestrictions []*ContentRestriction `json:"contentRestrictions,omitempty"`
	// CopyRequiresWriterPermission: Whether the options to copy, print, or
	// download this file, should be disabled for readers and commenters.
	CopyRequiresWriterPermission bool `json:"copyRequiresWriterPermission,omitempty"`
	// CreatedTime: The time at which the file was created (RFC 3339 date-time).
	CreatedTime string `json:"createdTime,omitempty"`
	// Description: A short description of the file.
	Description string `json:"description,omitempty"`
	// DriveId: Output only. ID of the shared drive the file resides in. Only
	// populated for items in shared drives.
	DriveId string `json:"driveId,omitempty"`
	// ExplicitlyTrashed: Output only. Whether the file has been explicitly
	// trashed, as opposed to recursively trashed from a parent folder.
	ExplicitlyTrashed bool `json:"explicitlyTrashed,omitempty"`
	// ExportLinks: Output only. Links for exporting Docs Editors files to specific
	// formats.
	ExportLinks map[string]string `json:"exportLinks,omitempty"`
	// FileExtension: Output only. The final component of `fullFileExtension`. This
	// is only available for files with binary content in Google Drive.
	FileExtension string `json:"fileExtension,omitempty"`
	// FolderColorRgb: The color for a folder or a shortcut to a folder as an RGB
	// hex string. The supported colors are published in the `folderColorPalette`
	// field of the About resource. If an unsupported color is specified, the
	// closest color in the palette is used instead.
	FolderColorRgb string `json:"folderColorRgb,omitempty"`
	// FullFileExtension: Output only. The full file extension extracted from the
	// `name` field. May contain multiple concatenated extensions, such as
	// "tar.gz". This is only available for files with binary content in Google
	// Drive. This is automatically updated when the `name` field changes, however
	// it is not cleared if the new name does not contain a valid extension.
	FullFileExtension string `json:"fullFileExtension,omitempty"`
	// HasAugmentedPermissions: Output only. Whether there are permissions directly
	// on this file. This field is only populated for items in shared drives.
	HasAugmentedPermissions bool `json:"hasAugmentedPermissions,omitempty"`
	// HasThumbnail: Output only. Whether this file has a thumbnail. This does not
	// indicate whether the requesting app has access to the thumbnail. To check
	// access, look for the presence of the thumbnailLink field.
	HasThumbnail bool `json:"hasThumbnail,omitempty"`
	// HeadRevisionId: Output only. The ID of the file's head revision. This is
	// currently only available for files with binary content in Google Drive.
	HeadRevisionId string `json:"headRevisionId,omitempty"`
	// IconLink: Output only. A static, unauthenticated link to the file's icon.
	IconLink string `json:"iconLink,omitempty"`
	// Id: The ID of the file.
	Id string `json:"id,omitempty"`
	// ImageMediaMetadata: Output only. Additional metadata about image media, if
	// available.
	ImageMediaMetadata *FileImageMediaMetadata `json:"imageMediaMetadata,omitempty"`
	// IsAppAuthorized: Output only. Whether the file was created or opened by the
	// requesting app.
	IsAppAuthorized bool `json:"isAppAuthorized,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#file".
	Kind string `json:"kind,omitempty"`
	// LabelInfo: Output only. An overview of the labels on the file.
	LabelInfo *FileLabelInfo `json:"labelInfo,omitempty"`
	// LastModifyingUser: Output only. The last user to modify the file. This field
	// is only populated when the last modification was performed by a signed-in
	// user.
	LastModifyingUser *User `json:"lastModifyingUser,omitempty"`
	// LinkShareMetadata: Contains details about the link URLs that clients are
	// using to refer to this item.
	LinkShareMetadata *FileLinkShareMetadata `json:"linkShareMetadata,omitempty"`
	// Md5Checksum: Output only. The MD5 checksum for the content of the file. This
	// is only applicable to files with binary content in Google Drive.
	Md5Checksum string `json:"md5Checksum,omitempty"`
	// MimeType: The MIME type of the file. Google Drive attempts to automatically
	// detect an appropriate value from uploaded content, if no value is provided.
	// The value cannot be changed unless a new revision is uploaded. If a file is
	// created with a Google Doc MIME type, the uploaded content is imported, if
	// possible. The supported import formats are published in the About resource.
	MimeType string `json:"mimeType,omitempty"`
	// ModifiedByMe: Output only. Whether the file has been modified by this user.
	ModifiedByMe bool `json:"modifiedByMe,omitempty"`
	// ModifiedByMeTime: The last time the file was modified by the user (RFC 3339
	// date-time).
	ModifiedByMeTime string `json:"modifiedByMeTime,omitempty"`
	// ModifiedTime: he last time the file was modified by anyone (RFC 3339
	// date-time). Note that setting modifiedTime will also update modifiedByMeTime
	// for the user.
	ModifiedTime string `json:"modifiedTime,omitempty"`
	// Name: The name of the file. This is not necessarily unique within a folder.
	// Note that for immutable items such as the top level folders of shared
	// drives, My Drive root folder, and Application Data folder the name is
	// constant.
	Name string `json:"name,omitempty"`
	// OriginalFilename: The original filename of the uploaded content if
	// available, or else the original value of the `name` field. This is only
	// available for files with binary content in Google Drive.
	OriginalFilename string `json:"originalFilename,omitempty"`
	// OwnedByMe: Output only. Whether the user owns the file. Not populated for
	// items in shared drives.
	OwnedByMe bool `json:"ownedByMe,omitempty"`
	// Owners: Output only. The owner of this file. Only certain legacy files may
	// have more than one owner. This field isn't populated for items in shared
	// drives.
	Owners []*User `json:"owners,omitempty"`
	// Parents: The ID of the parent folder containing the file. A file can only
	// have one parent folder; specifying multiple parents isn't supported. If not
	// specified as part of a create request, the file is placed directly in the
	// user's My Drive folder. If not specified as part of a copy request, the file
	// inherits any discoverable parent of the source file. Update requests must
	// use the `addParents` and `removeParents` parameters to modify the parents
	// list.
	Parents []string `json:"parents,omitempty"`
	// PermissionIds: Output only. List of permission IDs for users with access to
	// this file.
	PermissionIds []string `json:"permissionIds,omitempty"`
	// Permissions: Output only. The full list of permissions for the file. This is
	// only available if the requesting user can share the file. Not populated for
	// items in shared drives.
	Permissions []*Permission `json:"permissions,omitempty"`
	// Properties: A collection of arbitrary key-value pairs which are visible to
	// all apps.
	// Entries with null values are cleared in update and copy requests.
	Properties map[string]string `json:"properties,omitempty"`
	// QuotaBytesUsed: Output only. The number of storage quota bytes used by the
	// file. This includes the head revision as well as previous revisions with
	// `keepForever` enabled.
	QuotaBytesUsed int64 `json:"quotaBytesUsed,omitempty,string"`
	// ResourceKey: Output only. A key needed to access the item via a shared link.
	ResourceKey string `json:"resourceKey,omitempty"`
	// Sha1Checksum: Output only. The SHA1 checksum associated with this file, if
	// available. This field is only populated for files with content stored in
	// Google Drive; it is not populated for Docs Editors or shortcut files.
	Sha1Checksum string `json:"sha1Checksum,omitempty"`
	// Sha256Checksum: Output only. The SHA256 checksum associated with this file,
	// if available. This field is only populated for files with content stored in
	// Google Drive; it is not populated for Docs Editors or shortcut files.
	Sha256Checksum string `json:"sha256Checksum,omitempty"`
	// Shared: Output only. Whether the file has been shared. Not populated for
	// items in shared drives.
	Shared bool `json:"shared,omitempty"`
	// SharedWithMeTime: The time at which the file was shared with the user, if
	// applicable (RFC 3339 date-time).
	SharedWithMeTime string `json:"sharedWithMeTime,omitempty"`
	// SharingUser: Output only. The user who shared the file with the requesting
	// user, if applicable.
	SharingUser *User `json:"sharingUser,omitempty"`
	// ShortcutDetails: Shortcut file details. Only populated for shortcut files,
	// which have the mimeType field set to `application/vnd.google-apps.shortcut`.
	// Can only be set on `files.create` requests.
	ShortcutDetails *FileShortcutDetails `json:"shortcutDetails,omitempty"`
	// Size: Output only. Size in bytes of blobs and first party editor files.
	// Won't be populated for files that have no size, like shortcuts and folders.
	Size int64 `json:"size,omitempty,string"`
	// Spaces: Output only. The list of spaces which contain the file. The
	// currently supported values are 'drive', 'appDataFolder' and 'photos'.
	Spaces []string `json:"spaces,omitempty"`
	// Starred: Whether the user has starred the file.
	Starred bool `json:"starred,omitempty"`
	// TeamDriveId: Deprecated: Output only. Use `driveId` instead.
	TeamDriveId string `json:"teamDriveId,omitempty"`
	// ThumbnailLink: Output only. A short-lived link to the file's thumbnail, if
	// available. Typically lasts on the order of hours. Not intended for direct
	// usage on web applications due to Cross-Origin Resource Sharing (CORS)
	// (https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) policies, consider
	// using a proxy server. Only populated when the requesting app can access the
	// file's content. If the file isn't shared publicly, the URL returned in
	// `Files.thumbnailLink` must be fetched using a credentialed request.
	ThumbnailLink string `json:"thumbnailLink,omitempty"`
	// ThumbnailVersion: Output only. The thumbnail version for use in thumbnail
	// cache invalidation.
	ThumbnailVersion int64 `json:"thumbnailVersion,omitempty,string"`
	// Trashed: Whether the file has been trashed, either explicitly or from a
	// trashed parent folder. Only the owner may trash a file, and other users
	// cannot see files in the owner's trash.
	Trashed bool `json:"trashed,omitempty"`
	// TrashedTime: The time that the item was trashed (RFC 3339 date-time). Only
	// populated for items in shared drives.
	TrashedTime string `json:"trashedTime,omitempty"`
	// TrashingUser: Output only. If the file has been explicitly trashed, the user
	// who trashed it. Only populated for items in shared drives.
	TrashingUser *User `json:"trashingUser,omitempty"`
	// Version: Output only. A monotonically increasing version number for the
	// file. This reflects every change made to the file on the server, even those
	// not visible to the user.
	Version int64 `json:"version,omitempty,string"`
	// VideoMediaMetadata: Output only. Additional metadata about video media. This
	// may not be available immediately upon upload.
	VideoMediaMetadata *FileVideoMediaMetadata `json:"videoMediaMetadata,omitempty"`
	// ViewedByMe: Output only. Whether the file has been viewed by this user.
	ViewedByMe bool `json:"viewedByMe,omitempty"`
	// ViewedByMeTime: The last time the file was viewed by the user (RFC 3339
	// date-time).
	ViewedByMeTime string `json:"viewedByMeTime,omitempty"`
	// ViewersCanCopyContent: Deprecated: Use `copyRequiresWriterPermission`
	// instead.
	ViewersCanCopyContent bool `json:"viewersCanCopyContent,omitempty"`
	// WebContentLink: Output only. A link for downloading the content of the file
	// in a browser. This is only available for files with binary content in Google
	// Drive.
	WebContentLink string `json:"webContentLink,omitempty"`
	// WebViewLink: Output only. A link for opening the file in a relevant Google
	// editor or viewer in a browser.
	WebViewLink string `json:"webViewLink,omitempty"`
	// WritersCanShare: Whether users with only `writer` permission can modify the
	// file's permissions. Not populated for items in shared drives.
	WritersCanShare bool `json:"writersCanShare,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AppProperties") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AppProperties") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

File: The metadata for a file. Some resource methods (such as `files.update`) require a `fileId`. Use the `files.list` method to retrieve the ID for a file.

func (File) MarshalJSON

func (s File) MarshalJSON() ([]byte, error)

type FileCapabilities

type FileCapabilities struct {
	// CanAcceptOwnership: Output only. Whether the current user is the pending
	// owner of the file. Not populated for shared drive files.
	CanAcceptOwnership bool `json:"canAcceptOwnership,omitempty"`
	// CanAddChildren: Output only. Whether the current user can add children to
	// this folder. This is always false when the item is not a folder.
	CanAddChildren bool `json:"canAddChildren,omitempty"`
	// CanAddFolderFromAnotherDrive: Output only. Whether the current user can add
	// a folder from another drive (different shared drive or My Drive) to this
	// folder. This is false when the item is not a folder. Only populated for
	// items in shared drives.
	CanAddFolderFromAnotherDrive bool `json:"canAddFolderFromAnotherDrive,omitempty"`
	// CanAddMyDriveParent: Output only. Whether the current user can add a parent
	// for the item without removing an existing parent in the same request. Not
	// populated for shared drive files.
	CanAddMyDriveParent bool `json:"canAddMyDriveParent,omitempty"`
	// CanChangeCopyRequiresWriterPermission: Output only. Whether the current user
	// can change the `copyRequiresWriterPermission` restriction of this file.
	CanChangeCopyRequiresWriterPermission bool `json:"canChangeCopyRequiresWriterPermission,omitempty"`
	// CanChangeSecurityUpdateEnabled: Output only. Whether the current user can
	// change the securityUpdateEnabled field on link share metadata.
	CanChangeSecurityUpdateEnabled bool `json:"canChangeSecurityUpdateEnabled,omitempty"`
	// CanChangeViewersCanCopyContent: Deprecated: Output only.
	CanChangeViewersCanCopyContent bool `json:"canChangeViewersCanCopyContent,omitempty"`
	// CanComment: Output only. Whether the current user can comment on this file.
	CanComment bool `json:"canComment,omitempty"`
	// CanCopy: Output only. Whether the current user can copy this file. For an
	// item in a shared drive, whether the current user can copy non-folder
	// descendants of this item, or this item itself if it is not a folder.
	CanCopy bool `json:"canCopy,omitempty"`
	// CanDelete: Output only. Whether the current user can delete this file.
	CanDelete bool `json:"canDelete,omitempty"`
	// CanDeleteChildren: Output only. Whether the current user can delete children
	// of this folder. This is false when the item is not a folder. Only populated
	// for items in shared drives.
	CanDeleteChildren bool `json:"canDeleteChildren,omitempty"`
	// CanDownload: Output only. Whether the current user can download this file.
	CanDownload bool `json:"canDownload,omitempty"`
	// CanEdit: Output only. Whether the current user can edit this file. Other
	// factors may limit the type of changes a user can make to a file. For
	// example, see `canChangeCopyRequiresWriterPermission` or `canModifyContent`.
	CanEdit bool `json:"canEdit,omitempty"`
	// CanListChildren: Output only. Whether the current user can list the children
	// of this folder. This is always false when the item is not a folder.
	CanListChildren bool `json:"canListChildren,omitempty"`
	// CanModifyContent: Output only. Whether the current user can modify the
	// content of this file.
	CanModifyContent bool `json:"canModifyContent,omitempty"`
	// CanModifyContentRestriction: Deprecated: Output only. Use one of
	// `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` or
	// `canRemoveContentRestriction`.
	CanModifyContentRestriction bool `json:"canModifyContentRestriction,omitempty"`
	// CanModifyEditorContentRestriction: Output only. Whether the current user can
	// add or modify content restrictions on the file which are editor restricted.
	CanModifyEditorContentRestriction bool `json:"canModifyEditorContentRestriction,omitempty"`
	// CanModifyLabels: Output only. Whether the current user can modify the labels
	// on the file.
	CanModifyLabels bool `json:"canModifyLabels,omitempty"`
	// CanModifyOwnerContentRestriction: Output only. Whether the current user can
	// add or modify content restrictions which are owner restricted.
	CanModifyOwnerContentRestriction bool `json:"canModifyOwnerContentRestriction,omitempty"`
	// CanMoveChildrenOutOfDrive: Output only. Whether the current user can move
	// children of this folder outside of the shared drive. This is false when the
	// item is not a folder. Only populated for items in shared drives.
	CanMoveChildrenOutOfDrive bool `json:"canMoveChildrenOutOfDrive,omitempty"`
	// CanMoveChildrenOutOfTeamDrive: Deprecated: Output only. Use
	// `canMoveChildrenOutOfDrive` instead.
	CanMoveChildrenOutOfTeamDrive bool `json:"canMoveChildrenOutOfTeamDrive,omitempty"`
	// CanMoveChildrenWithinDrive: Output only. Whether the current user can move
	// children of this folder within this drive. This is false when the item is
	// not a folder. Note that a request to move the child may still fail depending
	// on the current user's access to the child and to the destination folder.
	CanMoveChildrenWithinDrive bool `json:"canMoveChildrenWithinDrive,omitempty"`
	// CanMoveChildrenWithinTeamDrive: Deprecated: Output only. Use
	// `canMoveChildrenWithinDrive` instead.
	CanMoveChildrenWithinTeamDrive bool `json:"canMoveChildrenWithinTeamDrive,omitempty"`
	// CanMoveItemIntoTeamDrive: Deprecated: Output only. Use
	// `canMoveItemOutOfDrive` instead.
	CanMoveItemIntoTeamDrive bool `json:"canMoveItemIntoTeamDrive,omitempty"`
	// CanMoveItemOutOfDrive: Output only. Whether the current user can move this
	// item outside of this drive by changing its parent. Note that a request to
	// change the parent of the item may still fail depending on the new parent
	// that is being added.
	CanMoveItemOutOfDrive bool `json:"canMoveItemOutOfDrive,omitempty"`
	// CanMoveItemOutOfTeamDrive: Deprecated: Output only. Use
	// `canMoveItemOutOfDrive` instead.
	CanMoveItemOutOfTeamDrive bool `json:"canMoveItemOutOfTeamDrive,omitempty"`
	// CanMoveItemWithinDrive: Output only. Whether the current user can move this
	// item within this drive. Note that a request to change the parent of the item
	// may still fail depending on the new parent that is being added and the
	// parent that is being removed.
	CanMoveItemWithinDrive bool `json:"canMoveItemWithinDrive,omitempty"`
	// CanMoveItemWithinTeamDrive: Deprecated: Output only. Use
	// `canMoveItemWithinDrive` instead.
	CanMoveItemWithinTeamDrive bool `json:"canMoveItemWithinTeamDrive,omitempty"`
	// CanMoveTeamDriveItem: Deprecated: Output only. Use `canMoveItemWithinDrive`
	// or `canMoveItemOutOfDrive` instead.
	CanMoveTeamDriveItem bool `json:"canMoveTeamDriveItem,omitempty"`
	// CanReadDrive: Output only. Whether the current user can read the shared
	// drive to which this file belongs. Only populated for items in shared drives.
	CanReadDrive bool `json:"canReadDrive,omitempty"`
	// CanReadLabels: Output only. Whether the current user can read the labels on
	// the file.
	CanReadLabels bool `json:"canReadLabels,omitempty"`
	// CanReadRevisions: Output only. Whether the current user can read the
	// revisions resource of this file. For a shared drive item, whether revisions
	// of non-folder descendants of this item, or this item itself if it is not a
	// folder, can be read.
	CanReadRevisions bool `json:"canReadRevisions,omitempty"`
	// CanReadTeamDrive: Deprecated: Output only. Use `canReadDrive` instead.
	CanReadTeamDrive bool `json:"canReadTeamDrive,omitempty"`
	// CanRemoveChildren: Output only. Whether the current user can remove children
	// from this folder. This is always false when the item is not a folder. For a
	// folder in a shared drive, use `canDeleteChildren` or `canTrashChildren`
	// instead.
	CanRemoveChildren bool `json:"canRemoveChildren,omitempty"`
	// CanRemoveContentRestriction: Output only. Whether there is a content
	// restriction on the file that can be removed by the current user.
	CanRemoveContentRestriction bool `json:"canRemoveContentRestriction,omitempty"`
	// CanRemoveMyDriveParent: Output only. Whether the current user can remove a
	// parent from the item without adding another parent in the same request. Not
	// populated for shared drive files.
	CanRemoveMyDriveParent bool `json:"canRemoveMyDriveParent,omitempty"`
	// CanRename: Output only. Whether the current user can rename this file.
	CanRename bool `json:"canRename,omitempty"`
	// CanShare: Output only. Whether the current user can modify the sharing
	// settings for this file.
	CanShare bool `json:"canShare,omitempty"`
	// CanTrash: Output only. Whether the current user can move this file to trash.
	CanTrash bool `json:"canTrash,omitempty"`
	// CanTrashChildren: Output only. Whether the current user can trash children
	// of this folder. This is false when the item is not a folder. Only populated
	// for items in shared drives.
	CanTrashChildren bool `json:"canTrashChildren,omitempty"`
	// CanUntrash: Output only. Whether the current user can restore this file from
	// trash.
	CanUntrash bool `json:"canUntrash,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CanAcceptOwnership") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CanAcceptOwnership") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileCapabilities: Output only. Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take.

func (FileCapabilities) MarshalJSON

func (s FileCapabilities) MarshalJSON() ([]byte, error)

type FileContentHints

type FileContentHints struct {
	// IndexableText: Text to be indexed for the file to improve fullText queries.
	// This is limited to 128KB in length and may contain HTML elements.
	IndexableText string `json:"indexableText,omitempty"`
	// Thumbnail: A thumbnail for the file. This will only be used if Google Drive
	// cannot generate a standard thumbnail.
	Thumbnail *FileContentHintsThumbnail `json:"thumbnail,omitempty"`
	// ForceSendFields is a list of field names (e.g. "IndexableText") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "IndexableText") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileContentHints: Additional information about the content of the file. These fields are never populated in responses.

func (FileContentHints) MarshalJSON

func (s FileContentHints) MarshalJSON() ([]byte, error)

type FileContentHintsThumbnail

type FileContentHintsThumbnail struct {
	// Image: The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5).
	Image string `json:"image,omitempty"`
	// MimeType: The MIME type of the thumbnail.
	MimeType string `json:"mimeType,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Image") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Image") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileContentHintsThumbnail: A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail.

func (FileContentHintsThumbnail) MarshalJSON

func (s FileContentHintsThumbnail) MarshalJSON() ([]byte, error)

type FileImageMediaMetadata

type FileImageMediaMetadata struct {
	// Aperture: Output only. The aperture used to create the photo (f-number).
	Aperture float64 `json:"aperture,omitempty"`
	// CameraMake: Output only. The make of the camera used to create the photo.
	CameraMake string `json:"cameraMake,omitempty"`
	// CameraModel: Output only. The model of the camera used to create the photo.
	CameraModel string `json:"cameraModel,omitempty"`
	// ColorSpace: Output only. The color space of the photo.
	ColorSpace string `json:"colorSpace,omitempty"`
	// ExposureBias: Output only. The exposure bias of the photo (APEX value).
	ExposureBias float64 `json:"exposureBias,omitempty"`
	// ExposureMode: Output only. The exposure mode used to create the photo.
	ExposureMode string `json:"exposureMode,omitempty"`
	// ExposureTime: Output only. The length of the exposure, in seconds.
	ExposureTime float64 `json:"exposureTime,omitempty"`
	// FlashUsed: Output only. Whether a flash was used to create the photo.
	FlashUsed bool `json:"flashUsed,omitempty"`
	// FocalLength: Output only. The focal length used to create the photo, in
	// millimeters.
	FocalLength float64 `json:"focalLength,omitempty"`
	// Height: Output only. The height of the image in pixels.
	Height int64 `json:"height,omitempty"`
	// IsoSpeed: Output only. The ISO speed used to create the photo.
	IsoSpeed int64 `json:"isoSpeed,omitempty"`
	// Lens: Output only. The lens used to create the photo.
	Lens string `json:"lens,omitempty"`
	// Location: Output only. Geographic location information stored in the image.
	Location *FileImageMediaMetadataLocation `json:"location,omitempty"`
	// MaxApertureValue: Output only. The smallest f-number of the lens at the
	// focal length used to create the photo (APEX value).
	MaxApertureValue float64 `json:"maxApertureValue,omitempty"`
	// MeteringMode: Output only. The metering mode used to create the photo.
	MeteringMode string `json:"meteringMode,omitempty"`
	// Rotation: Output only. The number of clockwise 90 degree rotations applied
	// from the image's original orientation.
	Rotation int64 `json:"rotation,omitempty"`
	// Sensor: Output only. The type of sensor used to create the photo.
	Sensor string `json:"sensor,omitempty"`
	// SubjectDistance: Output only. The distance to the subject of the photo, in
	// meters.
	SubjectDistance int64 `json:"subjectDistance,omitempty"`
	// Time: Output only. The date and time the photo was taken (EXIF DateTime).
	Time string `json:"time,omitempty"`
	// WhiteBalance: Output only. The white balance mode used to create the photo.
	WhiteBalance string `json:"whiteBalance,omitempty"`
	// Width: Output only. The width of the image in pixels.
	Width int64 `json:"width,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Aperture") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Aperture") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileImageMediaMetadata: Output only. Additional metadata about image media, if available.

func (FileImageMediaMetadata) MarshalJSON

func (s FileImageMediaMetadata) MarshalJSON() ([]byte, error)

func (*FileImageMediaMetadata) UnmarshalJSON

func (s *FileImageMediaMetadata) UnmarshalJSON(data []byte) error

type FileImageMediaMetadataLocation

type FileImageMediaMetadataLocation struct {
	// Altitude: Output only. The altitude stored in the image.
	Altitude float64 `json:"altitude,omitempty"`
	// Latitude: Output only. The latitude stored in the image.
	Latitude float64 `json:"latitude,omitempty"`
	// Longitude: Output only. The longitude stored in the image.
	Longitude float64 `json:"longitude,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Altitude") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Altitude") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileImageMediaMetadataLocation: Output only. Geographic location information stored in the image.

func (FileImageMediaMetadataLocation) MarshalJSON

func (s FileImageMediaMetadataLocation) MarshalJSON() ([]byte, error)

func (*FileImageMediaMetadataLocation) UnmarshalJSON

func (s *FileImageMediaMetadataLocation) UnmarshalJSON(data []byte) error

type FileLabelInfo added in v0.88.0

type FileLabelInfo struct {
	// Labels: Output only. The set of labels on the file as requested by the label
	// IDs in the `includeLabels` parameter. By default, no labels are returned.
	Labels []*Label `json:"labels,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Labels") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Labels") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileLabelInfo: Output only. An overview of the labels on the file.

func (FileLabelInfo) MarshalJSON added in v0.88.0

func (s FileLabelInfo) MarshalJSON() ([]byte, error)

type FileLinkShareMetadata added in v0.49.0

type FileLinkShareMetadata struct {
	// SecurityUpdateEligible: Output only. Whether the file is eligible for
	// security update.
	SecurityUpdateEligible bool `json:"securityUpdateEligible,omitempty"`
	// SecurityUpdateEnabled: Output only. Whether the security update is enabled
	// for this file.
	SecurityUpdateEnabled bool `json:"securityUpdateEnabled,omitempty"`
	// ForceSendFields is a list of field names (e.g. "SecurityUpdateEligible") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "SecurityUpdateEligible") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileLinkShareMetadata: Contains details about the link URLs that clients are using to refer to this item.

func (FileLinkShareMetadata) MarshalJSON added in v0.49.0

func (s FileLinkShareMetadata) MarshalJSON() ([]byte, error)

type FileList

type FileList struct {
	// Files: The list of files. If nextPageToken is populated, then this list may
	// be incomplete and an additional page of results should be fetched.
	Files []*File `json:"files,omitempty"`
	// IncompleteSearch: Whether the search process was incomplete. If true, then
	// some search results might be missing, since all documents were not searched.
	// This can occur when searching multiple drives with the 'allDrives' corpora,
	// but all corpora couldn't be searched. When this happens, it's suggested that
	// clients narrow their query by choosing a different corpus such as 'user' or
	// 'drive'.
	IncompleteSearch bool `json:"incompleteSearch,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#fileList".
	Kind string `json:"kind,omitempty"`
	// NextPageToken: The page token for the next page of files. This will be
	// absent if the end of the files list has been reached. If the token is
	// rejected for any reason, it should be discarded, and pagination should be
	// restarted from the first page of results. The page token is typically valid
	// for several hours. However, if new items are added or removed, your expected
	// results might differ.
	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. "Files") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Files") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileList: A list of files.

func (FileList) MarshalJSON

func (s FileList) MarshalJSON() ([]byte, error)

type FileShortcutDetails added in v0.22.0

type FileShortcutDetails struct {
	// TargetId: The ID of the file that this shortcut points to. Can only be set
	// on `files.create` requests.
	TargetId string `json:"targetId,omitempty"`
	// TargetMimeType: Output only. The MIME type of the file that this shortcut
	// points to. The value of this field is a snapshot of the target's MIME type,
	// captured when the shortcut is created.
	TargetMimeType string `json:"targetMimeType,omitempty"`
	// TargetResourceKey: Output only. The ResourceKey for the target file.
	TargetResourceKey string `json:"targetResourceKey,omitempty"`
	// ForceSendFields is a list of field names (e.g. "TargetId") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "TargetId") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileShortcutDetails: Shortcut file details. Only populated for shortcut files, which have the mimeType field set to `application/vnd.google-apps.shortcut`. Can only be set on `files.create` requests.

func (FileShortcutDetails) MarshalJSON added in v0.22.0

func (s FileShortcutDetails) MarshalJSON() ([]byte, error)

type FileVideoMediaMetadata

type FileVideoMediaMetadata struct {
	// DurationMillis: Output only. The duration of the video in milliseconds.
	DurationMillis int64 `json:"durationMillis,omitempty,string"`
	// Height: Output only. The height of the video in pixels.
	Height int64 `json:"height,omitempty"`
	// Width: Output only. The width of the video in pixels.
	Width int64 `json:"width,omitempty"`
	// ForceSendFields is a list of field names (e.g. "DurationMillis") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DurationMillis") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

FileVideoMediaMetadata: Output only. Additional metadata about video media. This may not be available immediately upon upload.

func (FileVideoMediaMetadata) MarshalJSON

func (s FileVideoMediaMetadata) MarshalJSON() ([]byte, error)

type FilesCopyCall

type FilesCopyCall struct {
	// contains filtered or unexported fields
}

func (*FilesCopyCall) Context

func (c *FilesCopyCall) Context(ctx context.Context) *FilesCopyCall

Context sets the context to be used in this call's Do method.

func (*FilesCopyCall) Do

func (c *FilesCopyCall) Do(opts ...googleapi.CallOption) (*File, error)

Do executes the "drive.files.copy" call. Any non-2xx status code is an error. Response headers are in either *File.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 (*FilesCopyCall) EnforceSingleParent added in v0.21.0

func (c *FilesCopyCall) EnforceSingleParent(enforceSingleParent bool) *FilesCopyCall

EnforceSingleParent sets the optional parameter "enforceSingleParent": Deprecated. Copying files into multiple folders is no longer supported. Use shortcuts instead.

func (*FilesCopyCall) Fields

func (c *FilesCopyCall) Fields(s ...googleapi.Field) *FilesCopyCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesCopyCall) Header

func (c *FilesCopyCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesCopyCall) IgnoreDefaultVisibility

func (c *FilesCopyCall) IgnoreDefaultVisibility(ignoreDefaultVisibility bool) *FilesCopyCall

IgnoreDefaultVisibility sets the optional parameter "ignoreDefaultVisibility": Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.

func (*FilesCopyCall) IncludeLabels added in v0.88.0

func (c *FilesCopyCall) IncludeLabels(includeLabels string) *FilesCopyCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*FilesCopyCall) IncludePermissionsForView added in v0.31.0

func (c *FilesCopyCall) IncludePermissionsForView(includePermissionsForView string) *FilesCopyCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*FilesCopyCall) KeepRevisionForever

func (c *FilesCopyCall) KeepRevisionForever(keepRevisionForever bool) *FilesCopyCall

KeepRevisionForever sets the optional parameter "keepRevisionForever": Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.

func (*FilesCopyCall) OcrLanguage

func (c *FilesCopyCall) OcrLanguage(ocrLanguage string) *FilesCopyCall

OcrLanguage sets the optional parameter "ocrLanguage": A language hint for OCR processing during image import (ISO 639-1 code).

func (*FilesCopyCall) SupportsAllDrives added in v0.4.0

func (c *FilesCopyCall) SupportsAllDrives(supportsAllDrives bool) *FilesCopyCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*FilesCopyCall) SupportsTeamDrives

func (c *FilesCopyCall) SupportsTeamDrives(supportsTeamDrives bool) *FilesCopyCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

type FilesCreateCall

type FilesCreateCall struct {
	// contains filtered or unexported fields
}

func (*FilesCreateCall) Context

Context sets the context to be used in this call's Do method. This context will supersede any context previously provided to the ResumableMedia method.

func (*FilesCreateCall) Do

func (c *FilesCreateCall) Do(opts ...googleapi.CallOption) (*File, error)

Do executes the "drive.files.create" call. Any non-2xx status code is an error. Response headers are in either *File.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 (*FilesCreateCall) EnforceSingleParent added in v0.21.0

func (c *FilesCreateCall) EnforceSingleParent(enforceSingleParent bool) *FilesCreateCall

EnforceSingleParent sets the optional parameter "enforceSingleParent": Deprecated. Creating files in multiple folders is no longer supported.

func (*FilesCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesCreateCall) Header

func (c *FilesCreateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesCreateCall) IgnoreDefaultVisibility

func (c *FilesCreateCall) IgnoreDefaultVisibility(ignoreDefaultVisibility bool) *FilesCreateCall

IgnoreDefaultVisibility sets the optional parameter "ignoreDefaultVisibility": Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.

func (*FilesCreateCall) IncludeLabels added in v0.88.0

func (c *FilesCreateCall) IncludeLabels(includeLabels string) *FilesCreateCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*FilesCreateCall) IncludePermissionsForView added in v0.31.0

func (c *FilesCreateCall) IncludePermissionsForView(includePermissionsForView string) *FilesCreateCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*FilesCreateCall) KeepRevisionForever

func (c *FilesCreateCall) KeepRevisionForever(keepRevisionForever bool) *FilesCreateCall

KeepRevisionForever sets the optional parameter "keepRevisionForever": Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.

func (*FilesCreateCall) Media

func (c *FilesCreateCall) Media(r io.Reader, options ...googleapi.MediaOption) *FilesCreateCall

Media specifies the media to upload in one or more chunks. The chunk size may be controlled by supplying a MediaOption generated by googleapi.ChunkSize. The chunk size defaults to googleapi.DefaultUploadChunkSize.The Content-Type header used in the upload request will be determined by sniffing the contents of r, unless a MediaOption generated by googleapi.ContentType is supplied. At most one of Media and ResumableMedia may be set.

func (*FilesCreateCall) OcrLanguage

func (c *FilesCreateCall) OcrLanguage(ocrLanguage string) *FilesCreateCall

OcrLanguage sets the optional parameter "ocrLanguage": A language hint for OCR processing during image import (ISO 639-1 code).

func (*FilesCreateCall) ProgressUpdater

func (c *FilesCreateCall) ProgressUpdater(pu googleapi.ProgressUpdater) *FilesCreateCall

ProgressUpdater provides a callback function that will be called after every chunk. It should be a low-latency function in order to not slow down the upload operation. This should only be called when using ResumableMedia (as opposed to Media).

func (*FilesCreateCall) ResumableMedia deprecated

func (c *FilesCreateCall) ResumableMedia(ctx context.Context, r io.ReaderAt, size int64, mediaType string) *FilesCreateCall

ResumableMedia specifies the media to upload in chunks and can be canceled with ctx.

Deprecated: use Media instead.

At most one of Media and ResumableMedia may be set. mediaType identifies the MIME media type of the upload, such as "image/png". If mediaType is "", it will be auto-detected. The provided ctx will supersede any context previously provided to the Context method.

func (*FilesCreateCall) SupportsAllDrives added in v0.4.0

func (c *FilesCreateCall) SupportsAllDrives(supportsAllDrives bool) *FilesCreateCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*FilesCreateCall) SupportsTeamDrives

func (c *FilesCreateCall) SupportsTeamDrives(supportsTeamDrives bool) *FilesCreateCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*FilesCreateCall) UseContentAsIndexableText

func (c *FilesCreateCall) UseContentAsIndexableText(useContentAsIndexableText bool) *FilesCreateCall

UseContentAsIndexableText sets the optional parameter "useContentAsIndexableText": Whether to use the uploaded content as indexable text.

type FilesDeleteCall

type FilesDeleteCall struct {
	// contains filtered or unexported fields
}

func (*FilesDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*FilesDeleteCall) Do

func (c *FilesDeleteCall) Do(opts ...googleapi.CallOption) error

Do executes the "drive.files.delete" call.

func (*FilesDeleteCall) EnforceSingleParent added in v0.31.0

func (c *FilesDeleteCall) EnforceSingleParent(enforceSingleParent bool) *FilesDeleteCall

EnforceSingleParent sets the optional parameter "enforceSingleParent": Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.

func (*FilesDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesDeleteCall) Header

func (c *FilesDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesDeleteCall) SupportsAllDrives added in v0.4.0

func (c *FilesDeleteCall) SupportsAllDrives(supportsAllDrives bool) *FilesDeleteCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*FilesDeleteCall) SupportsTeamDrives

func (c *FilesDeleteCall) SupportsTeamDrives(supportsTeamDrives bool) *FilesDeleteCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

type FilesEmptyTrashCall

type FilesEmptyTrashCall struct {
	// contains filtered or unexported fields
}

func (*FilesEmptyTrashCall) Context

Context sets the context to be used in this call's Do method.

func (*FilesEmptyTrashCall) Do

Do executes the "drive.files.emptyTrash" call.

func (*FilesEmptyTrashCall) DriveId added in v0.120.0

func (c *FilesEmptyTrashCall) DriveId(driveId string) *FilesEmptyTrashCall

DriveId sets the optional parameter "driveId": If set, empties the trash of the provided shared drive.

func (*FilesEmptyTrashCall) EnforceSingleParent added in v0.31.0

func (c *FilesEmptyTrashCall) EnforceSingleParent(enforceSingleParent bool) *FilesEmptyTrashCall

EnforceSingleParent sets the optional parameter "enforceSingleParent": Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root.

func (*FilesEmptyTrashCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesEmptyTrashCall) Header

func (c *FilesEmptyTrashCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type FilesExportCall

type FilesExportCall struct {
	// contains filtered or unexported fields
}

func (*FilesExportCall) Context

Context sets the context to be used in this call's Do and Download methods.

func (*FilesExportCall) Do

func (c *FilesExportCall) Do(opts ...googleapi.CallOption) error

Do executes the "drive.files.export" call.

func (*FilesExportCall) Download

func (c *FilesExportCall) Download(opts ...googleapi.CallOption) (*http.Response, error)

Download fetches the API endpoint's "media" value, instead of the normal API response value. If the returned error is nil, the Response is guaranteed to have a 2xx status code. Callers must close the Response.Body as usual.

func (*FilesExportCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesExportCall) Header

func (c *FilesExportCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesExportCall) IfNoneMatch

func (c *FilesExportCall) IfNoneMatch(entityTag string) *FilesExportCall

IfNoneMatch sets an 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.

type FilesGenerateIdsCall

type FilesGenerateIdsCall struct {
	// contains filtered or unexported fields
}

func (*FilesGenerateIdsCall) Context

Context sets the context to be used in this call's Do method.

func (*FilesGenerateIdsCall) Count

Count sets the optional parameter "count": The number of IDs to return.

func (*FilesGenerateIdsCall) Do

Do executes the "drive.files.generateIds" call. Any non-2xx status code is an error. Response headers are in either *GeneratedIds.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 (*FilesGenerateIdsCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesGenerateIdsCall) Header

func (c *FilesGenerateIdsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesGenerateIdsCall) IfNoneMatch

func (c *FilesGenerateIdsCall) IfNoneMatch(entityTag string) *FilesGenerateIdsCall

IfNoneMatch sets an 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.

func (*FilesGenerateIdsCall) Space

Space sets the optional parameter "space": The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'. (Default: 'drive')

func (*FilesGenerateIdsCall) Type added in v0.47.0

Type sets the optional parameter "type": The type of items which the IDs can be used for. Supported values are 'files' and 'shortcuts'. Note that 'shortcuts' are only supported in the `drive` 'space'. (Default: 'files')

type FilesGetCall

type FilesGetCall struct {
	// contains filtered or unexported fields
}

func (*FilesGetCall) AcknowledgeAbuse

func (c *FilesGetCall) AcknowledgeAbuse(acknowledgeAbuse bool) *FilesGetCall

AcknowledgeAbuse sets the optional parameter "acknowledgeAbuse": Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.

func (*FilesGetCall) Context

func (c *FilesGetCall) Context(ctx context.Context) *FilesGetCall

Context sets the context to be used in this call's Do and Download methods.

func (*FilesGetCall) Do

func (c *FilesGetCall) Do(opts ...googleapi.CallOption) (*File, error)

Do executes the "drive.files.get" call. Any non-2xx status code is an error. Response headers are in either *File.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 (*FilesGetCall) Download

func (c *FilesGetCall) Download(opts ...googleapi.CallOption) (*http.Response, error)

Download fetches the API endpoint's "media" value, instead of the normal API response value. If the returned error is nil, the Response is guaranteed to have a 2xx status code. Callers must close the Response.Body as usual.

func (*FilesGetCall) Fields

func (c *FilesGetCall) Fields(s ...googleapi.Field) *FilesGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesGetCall) Header

func (c *FilesGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesGetCall) IfNoneMatch

func (c *FilesGetCall) IfNoneMatch(entityTag string) *FilesGetCall

IfNoneMatch sets an 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.

func (*FilesGetCall) IncludeLabels added in v0.88.0

func (c *FilesGetCall) IncludeLabels(includeLabels string) *FilesGetCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*FilesGetCall) IncludePermissionsForView added in v0.31.0

func (c *FilesGetCall) IncludePermissionsForView(includePermissionsForView string) *FilesGetCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*FilesGetCall) SupportsAllDrives added in v0.4.0

func (c *FilesGetCall) SupportsAllDrives(supportsAllDrives bool) *FilesGetCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*FilesGetCall) SupportsTeamDrives

func (c *FilesGetCall) SupportsTeamDrives(supportsTeamDrives bool) *FilesGetCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

type FilesListCall

type FilesListCall struct {
	// contains filtered or unexported fields
}

func (*FilesListCall) Context

func (c *FilesListCall) Context(ctx context.Context) *FilesListCall

Context sets the context to be used in this call's Do method.

func (*FilesListCall) Corpora

func (c *FilesListCall) Corpora(corpora string) *FilesListCall

Corpora sets the optional parameter "corpora": Bodies of items (files/documents) to which the query applies. Supported bodies are 'user', 'domain', 'drive', and 'allDrives'. Prefer 'user' or 'drive' to 'allDrives' for efficiency. By default, corpora is set to 'user'. However, this can change depending on the filter set through the 'q' parameter.

func (*FilesListCall) Corpus

func (c *FilesListCall) Corpus(corpus string) *FilesListCall

Corpus sets the optional parameter "corpus": Deprecated: The source of files to list. Use 'corpora' instead.

Possible values:

"domain" - Files shared to the user's domain.
"user" - Files owned by or shared to the user.

func (*FilesListCall) Do

func (c *FilesListCall) Do(opts ...googleapi.CallOption) (*FileList, error)

Do executes the "drive.files.list" call. Any non-2xx status code is an error. Response headers are in either *FileList.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 (*FilesListCall) DriveId added in v0.4.0

func (c *FilesListCall) DriveId(driveId string) *FilesListCall

DriveId sets the optional parameter "driveId": ID of the shared drive to search.

func (*FilesListCall) Fields

func (c *FilesListCall) Fields(s ...googleapi.Field) *FilesListCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesListCall) Header

func (c *FilesListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesListCall) IfNoneMatch

func (c *FilesListCall) IfNoneMatch(entityTag string) *FilesListCall

IfNoneMatch sets an 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.

func (*FilesListCall) IncludeItemsFromAllDrives added in v0.4.0

func (c *FilesListCall) IncludeItemsFromAllDrives(includeItemsFromAllDrives bool) *FilesListCall

IncludeItemsFromAllDrives sets the optional parameter "includeItemsFromAllDrives": Whether both My Drive and shared drive items should be included in results.

func (*FilesListCall) IncludeLabels added in v0.88.0

func (c *FilesListCall) IncludeLabels(includeLabels string) *FilesListCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*FilesListCall) IncludePermissionsForView added in v0.31.0

func (c *FilesListCall) IncludePermissionsForView(includePermissionsForView string) *FilesListCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*FilesListCall) IncludeTeamDriveItems

func (c *FilesListCall) IncludeTeamDriveItems(includeTeamDriveItems bool) *FilesListCall

IncludeTeamDriveItems sets the optional parameter "includeTeamDriveItems": Deprecated: Use `includeItemsFromAllDrives` instead.

func (*FilesListCall) OrderBy

func (c *FilesListCall) OrderBy(orderBy string) *FilesListCall

OrderBy sets the optional parameter "orderBy": A comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts ascending by default, but can be reversed with the 'desc' modifier. Example usage: ?orderBy=folder,modifiedTime desc,name.

func (*FilesListCall) PageSize

func (c *FilesListCall) PageSize(pageSize int64) *FilesListCall

PageSize sets the optional parameter "pageSize": The maximum number of files to return per page. Partial or empty result pages are possible even before the end of the files list has been reached.

func (*FilesListCall) PageToken

func (c *FilesListCall) PageToken(pageToken string) *FilesListCall

PageToken sets the optional parameter "pageToken": The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

func (*FilesListCall) Pages

func (c *FilesListCall) Pages(ctx context.Context, f func(*FileList) error) error

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 (*FilesListCall) Q

Q sets the optional parameter "q": A query for filtering the file results. See the "Search for files & folders" guide for supported syntax.

func (*FilesListCall) Spaces

func (c *FilesListCall) Spaces(spaces string) *FilesListCall

Spaces sets the optional parameter "spaces": A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.

func (*FilesListCall) SupportsAllDrives added in v0.4.0

func (c *FilesListCall) SupportsAllDrives(supportsAllDrives bool) *FilesListCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*FilesListCall) SupportsTeamDrives

func (c *FilesListCall) SupportsTeamDrives(supportsTeamDrives bool) *FilesListCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*FilesListCall) TeamDriveId

func (c *FilesListCall) TeamDriveId(teamDriveId string) *FilesListCall

TeamDriveId sets the optional parameter "teamDriveId": Deprecated: Use `driveId` instead.

type FilesListLabelsCall added in v0.88.0

type FilesListLabelsCall struct {
	// contains filtered or unexported fields
}

func (*FilesListLabelsCall) Context added in v0.88.0

Context sets the context to be used in this call's Do method.

func (*FilesListLabelsCall) Do added in v0.88.0

Do executes the "drive.files.listLabels" call. Any non-2xx status code is an error. Response headers are in either *LabelList.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 (*FilesListLabelsCall) Fields added in v0.88.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesListLabelsCall) Header added in v0.88.0

func (c *FilesListLabelsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesListLabelsCall) IfNoneMatch added in v0.88.0

func (c *FilesListLabelsCall) IfNoneMatch(entityTag string) *FilesListLabelsCall

IfNoneMatch sets an 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.

func (*FilesListLabelsCall) MaxResults added in v0.88.0

func (c *FilesListLabelsCall) MaxResults(maxResults int64) *FilesListLabelsCall

MaxResults sets the optional parameter "maxResults": The maximum number of labels to return per page. When not set, defaults to 100.

func (*FilesListLabelsCall) PageToken added in v0.88.0

func (c *FilesListLabelsCall) PageToken(pageToken string) *FilesListLabelsCall

PageToken sets the optional parameter "pageToken": The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

func (*FilesListLabelsCall) Pages added in v0.88.0

func (c *FilesListLabelsCall) Pages(ctx context.Context, f func(*LabelList) error) error

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.

type FilesModifyLabelsCall added in v0.88.0

type FilesModifyLabelsCall struct {
	// contains filtered or unexported fields
}

func (*FilesModifyLabelsCall) Context added in v0.88.0

Context sets the context to be used in this call's Do method.

func (*FilesModifyLabelsCall) Do added in v0.88.0

Do executes the "drive.files.modifyLabels" call. Any non-2xx status code is an error. Response headers are in either *ModifyLabelsResponse.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 (*FilesModifyLabelsCall) Fields added in v0.88.0

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesModifyLabelsCall) Header added in v0.88.0

func (c *FilesModifyLabelsCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type FilesService

type FilesService struct {
	// contains filtered or unexported fields
}

func NewFilesService

func NewFilesService(s *Service) *FilesService

func (*FilesService) Copy

func (r *FilesService) Copy(fileId string, file *File) *FilesCopyCall

Copy: Creates a copy of a file and applies any requested updates with patch semantics.

- fileId: The ID of the file.

func (*FilesService) Create

func (r *FilesService) Create(file *File) *FilesCreateCall

Create: Creates a new file. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see Upload file data (/drive/api/guides/manage-uploads). Apps creating shortcuts with `files.create` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like "name": "cat.jpg" in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `title` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the title. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type.

func (*FilesService) Delete

func (r *FilesService) Delete(fileId string) *FilesDeleteCall

Delete: Permanently deletes a file owned by the user without moving it to the trash. If the file belongs to a shared drive, the user must be an `organizer` on the parent folder. If the target is a folder, all descendants owned by the user are also deleted.

- fileId: The ID of the file.

func (*FilesService) EmptyTrash

func (r *FilesService) EmptyTrash() *FilesEmptyTrashCall

EmptyTrash: Permanently deletes all of the user's trashed files.

func (*FilesService) Export

func (r *FilesService) Export(fileId string, mimeType string) *FilesExportCall

Export: Exports a Google Workspace document to the requested MIME type and returns exported byte content. Note that the exported content is limited to 10MB.

- fileId: The ID of the file. - mimeType: The MIME type of the format requested for this export.

func (*FilesService) GenerateIds

func (r *FilesService) GenerateIds() *FilesGenerateIdsCall

GenerateIds: Generates a set of file IDs which can be provided in create or copy requests.

func (*FilesService) Get

func (r *FilesService) Get(fileId string) *FilesGetCall

Get: Gets a file's metadata or content by ID. If you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use `files.export` (/drive/api/reference/rest/v3/files/export) instead. For more information, see Download & export files (/drive/api/guides/manage-downloads).

- fileId: The ID of the file.

func (*FilesService) List

func (r *FilesService) List() *FilesListCall

List: Lists the user's files. This method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the Search for files & folders (/drive/api/guides/search-files) guide. *Note:* This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results.

func (*FilesService) ListLabels added in v0.88.0

func (r *FilesService) ListLabels(fileId string) *FilesListLabelsCall

ListLabels: Lists the labels on a file.

- fileId: The ID for the file.

func (*FilesService) ModifyLabels added in v0.88.0

func (r *FilesService) ModifyLabels(fileId string, modifylabelsrequest *ModifyLabelsRequest) *FilesModifyLabelsCall

ModifyLabels: Modifies the set of labels applied to a file. Returns a list of the labels that were added or modified.

- fileId: The ID of the file to which the labels belong.

func (*FilesService) Update

func (r *FilesService) Update(fileId string, file *File) *FilesUpdateCall

Update: Updates a file's metadata and/or content. When calling this method, only populate fields in the request that you want to modify. When updating fields, some fields might be changed automatically, such as `modifiedDate`. This method supports patch semantics. This method supports an */upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*/*` Note: Specify a valid MIME type, rather than the literal `*/*` value. The literal `*/*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see Upload file data (/drive/api/guides/manage-uploads).

- fileId: The ID of the file.

func (*FilesService) Watch

func (r *FilesService) Watch(fileId string, channel *Channel) *FilesWatchCall

Watch: Subscribes to changes to a file.

- fileId: The ID of the file.

type FilesUpdateCall

type FilesUpdateCall struct {
	// contains filtered or unexported fields
}

func (*FilesUpdateCall) AddParents

func (c *FilesUpdateCall) AddParents(addParents string) *FilesUpdateCall

AddParents sets the optional parameter "addParents": A comma-separated list of parent IDs to add.

func (*FilesUpdateCall) Context

Context sets the context to be used in this call's Do method. This context will supersede any context previously provided to the ResumableMedia method.

func (*FilesUpdateCall) Do

func (c *FilesUpdateCall) Do(opts ...googleapi.CallOption) (*File, error)

Do executes the "drive.files.update" call. Any non-2xx status code is an error. Response headers are in either *File.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 (*FilesUpdateCall) EnforceSingleParent added in v0.21.0

func (c *FilesUpdateCall) EnforceSingleParent(enforceSingleParent bool) *FilesUpdateCall

EnforceSingleParent sets the optional parameter "enforceSingleParent": Deprecated: Adding files to multiple folders is no longer supported. Use shortcuts instead.

func (*FilesUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesUpdateCall) Header

func (c *FilesUpdateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesUpdateCall) IncludeLabels added in v0.88.0

func (c *FilesUpdateCall) IncludeLabels(includeLabels string) *FilesUpdateCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*FilesUpdateCall) IncludePermissionsForView added in v0.31.0

func (c *FilesUpdateCall) IncludePermissionsForView(includePermissionsForView string) *FilesUpdateCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*FilesUpdateCall) KeepRevisionForever

func (c *FilesUpdateCall) KeepRevisionForever(keepRevisionForever bool) *FilesUpdateCall

KeepRevisionForever sets the optional parameter "keepRevisionForever": Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.

func (*FilesUpdateCall) Media

func (c *FilesUpdateCall) Media(r io.Reader, options ...googleapi.MediaOption) *FilesUpdateCall

Media specifies the media to upload in one or more chunks. The chunk size may be controlled by supplying a MediaOption generated by googleapi.ChunkSize. The chunk size defaults to googleapi.DefaultUploadChunkSize.The Content-Type header used in the upload request will be determined by sniffing the contents of r, unless a MediaOption generated by googleapi.ContentType is supplied. At most one of Media and ResumableMedia may be set.

func (*FilesUpdateCall) OcrLanguage

func (c *FilesUpdateCall) OcrLanguage(ocrLanguage string) *FilesUpdateCall

OcrLanguage sets the optional parameter "ocrLanguage": A language hint for OCR processing during image import (ISO 639-1 code).

func (*FilesUpdateCall) ProgressUpdater

func (c *FilesUpdateCall) ProgressUpdater(pu googleapi.ProgressUpdater) *FilesUpdateCall

ProgressUpdater provides a callback function that will be called after every chunk. It should be a low-latency function in order to not slow down the upload operation. This should only be called when using ResumableMedia (as opposed to Media).

func (*FilesUpdateCall) RemoveParents

func (c *FilesUpdateCall) RemoveParents(removeParents string) *FilesUpdateCall

RemoveParents sets the optional parameter "removeParents": A comma-separated list of parent IDs to remove.

func (*FilesUpdateCall) ResumableMedia deprecated

func (c *FilesUpdateCall) ResumableMedia(ctx context.Context, r io.ReaderAt, size int64, mediaType string) *FilesUpdateCall

ResumableMedia specifies the media to upload in chunks and can be canceled with ctx.

Deprecated: use Media instead.

At most one of Media and ResumableMedia may be set. mediaType identifies the MIME media type of the upload, such as "image/png". If mediaType is "", it will be auto-detected. The provided ctx will supersede any context previously provided to the Context method.

func (*FilesUpdateCall) SupportsAllDrives added in v0.4.0

func (c *FilesUpdateCall) SupportsAllDrives(supportsAllDrives bool) *FilesUpdateCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*FilesUpdateCall) SupportsTeamDrives

func (c *FilesUpdateCall) SupportsTeamDrives(supportsTeamDrives bool) *FilesUpdateCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*FilesUpdateCall) UseContentAsIndexableText

func (c *FilesUpdateCall) UseContentAsIndexableText(useContentAsIndexableText bool) *FilesUpdateCall

UseContentAsIndexableText sets the optional parameter "useContentAsIndexableText": Whether to use the uploaded content as indexable text.

type FilesWatchCall

type FilesWatchCall struct {
	// contains filtered or unexported fields
}

func (*FilesWatchCall) AcknowledgeAbuse

func (c *FilesWatchCall) AcknowledgeAbuse(acknowledgeAbuse bool) *FilesWatchCall

AcknowledgeAbuse sets the optional parameter "acknowledgeAbuse": Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.

func (*FilesWatchCall) Context

func (c *FilesWatchCall) Context(ctx context.Context) *FilesWatchCall

Context sets the context to be used in this call's Do method.

func (*FilesWatchCall) Do

func (c *FilesWatchCall) Do(opts ...googleapi.CallOption) (*Channel, error)

Do executes the "drive.files.watch" call. Any non-2xx status code is an error. Response headers are in either *Channel.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 (*FilesWatchCall) Fields

func (c *FilesWatchCall) Fields(s ...googleapi.Field) *FilesWatchCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*FilesWatchCall) Header

func (c *FilesWatchCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*FilesWatchCall) IncludeLabels added in v0.88.0

func (c *FilesWatchCall) IncludeLabels(includeLabels string) *FilesWatchCall

IncludeLabels sets the optional parameter "includeLabels": A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.

func (*FilesWatchCall) IncludePermissionsForView added in v0.31.0

func (c *FilesWatchCall) IncludePermissionsForView(includePermissionsForView string) *FilesWatchCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*FilesWatchCall) SupportsAllDrives added in v0.4.0

func (c *FilesWatchCall) SupportsAllDrives(supportsAllDrives bool) *FilesWatchCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*FilesWatchCall) SupportsTeamDrives

func (c *FilesWatchCall) SupportsTeamDrives(supportsTeamDrives bool) *FilesWatchCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

type GeneratedIds

type GeneratedIds struct {
	// Ids: The IDs generated for the requesting user in the specified space.
	Ids []string `json:"ids,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#generatedIds".
	Kind string `json:"kind,omitempty"`
	// Space: The type of file that can be created with these IDs.
	Space string `json:"space,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Ids") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Ids") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

GeneratedIds: A list of generated file IDs which can be provided in create requests.

func (GeneratedIds) MarshalJSON

func (s GeneratedIds) MarshalJSON() ([]byte, error)

type Label added in v0.88.0

type Label struct {
	// Fields: A map of the fields on the label, keyed by the field's ID.
	Fields map[string]LabelField `json:"fields,omitempty"`
	// Id: The ID of the label.
	Id string `json:"id,omitempty"`
	// Kind: This is always drive#label
	Kind string `json:"kind,omitempty"`
	// RevisionId: The revision ID of the label.
	RevisionId string `json:"revisionId,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Fields") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Fields") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Label: Representation of label and label fields.

func (Label) MarshalJSON added in v0.88.0

func (s Label) MarshalJSON() ([]byte, error)

type LabelField added in v0.88.0

type LabelField struct {
	// DateString: Only present if valueType is dateString. RFC 3339 formatted
	// date: YYYY-MM-DD.
	DateString []string `json:"dateString,omitempty"`
	// Id: The identifier of this label field.
	Id string `json:"id,omitempty"`
	// Integer: Only present if `valueType` is `integer`.
	Integer googleapi.Int64s `json:"integer,omitempty"`
	// Kind: This is always drive#labelField.
	Kind string `json:"kind,omitempty"`
	// Selection: Only present if `valueType` is `selection`
	Selection []string `json:"selection,omitempty"`
	// Text: Only present if `valueType` is `text`.
	Text []string `json:"text,omitempty"`
	// User: Only present if `valueType` is `user`.
	User []*User `json:"user,omitempty"`
	// ValueType: The field type. While new values may be supported in the future,
	// the following are currently allowed: * `dateString` * `integer` *
	// `selection` * `text` * `user`
	ValueType string `json:"valueType,omitempty"`
	// ForceSendFields is a list of field names (e.g. "DateString") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DateString") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

LabelField: Representation of field, which is a typed key-value pair.

func (LabelField) MarshalJSON added in v0.88.0

func (s LabelField) MarshalJSON() ([]byte, error)

type LabelFieldModification added in v0.88.0

type LabelFieldModification struct {
	// FieldId: The ID of the field to be modified.
	FieldId string `json:"fieldId,omitempty"`
	// Kind: This is always drive#labelFieldModification.
	Kind string `json:"kind,omitempty"`
	// SetDateValues: Replaces the value of a dateString Field with these new
	// values. The string must be in the RFC 3339 full-date format: YYYY-MM-DD.
	SetDateValues []string `json:"setDateValues,omitempty"`
	// SetIntegerValues: Replaces the value of an `integer` field with these new
	// values.
	SetIntegerValues googleapi.Int64s `json:"setIntegerValues,omitempty"`
	// SetSelectionValues: Replaces a `selection` field with these new values.
	SetSelectionValues []string `json:"setSelectionValues,omitempty"`
	// SetTextValues: Sets the value of a `text` field.
	SetTextValues []string `json:"setTextValues,omitempty"`
	// SetUserValues: Replaces a `user` field with these new values. The values
	// must be valid email addresses.
	SetUserValues []string `json:"setUserValues,omitempty"`
	// UnsetValues: Unsets the values for this field.
	UnsetValues bool `json:"unsetValues,omitempty"`
	// ForceSendFields is a list of field names (e.g. "FieldId") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "FieldId") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

LabelFieldModification: A modification to a label's field.

func (LabelFieldModification) MarshalJSON added in v0.88.0

func (s LabelFieldModification) MarshalJSON() ([]byte, error)

type LabelList added in v0.88.0

type LabelList struct {
	// Kind: This is always drive#labelList
	Kind string `json:"kind,omitempty"`
	// Labels: The list of labels.
	Labels []*Label `json:"labels,omitempty"`
	// NextPageToken: The page token for the next page of labels. This field will
	// be absent if the end of the list has been reached. If the token is rejected
	// for any reason, it should be discarded, and pagination should be restarted
	// from the first page of results. The page token is typically valid for
	// several hours. However, if new items are added or removed, your expected
	// results might differ.
	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. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

LabelList: A list of labels applied to a file.

func (LabelList) MarshalJSON added in v0.88.0

func (s LabelList) MarshalJSON() ([]byte, error)

type LabelModification added in v0.88.0

type LabelModification struct {
	// FieldModifications: The list of modifications to this label's fields.
	FieldModifications []*LabelFieldModification `json:"fieldModifications,omitempty"`
	// Kind: This is always drive#labelModification.
	Kind string `json:"kind,omitempty"`
	// LabelId: The ID of the label to modify.
	LabelId string `json:"labelId,omitempty"`
	// RemoveLabel: If true, the label will be removed from the file.
	RemoveLabel bool `json:"removeLabel,omitempty"`
	// ForceSendFields is a list of field names (e.g. "FieldModifications") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "FieldModifications") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

LabelModification: A modification to a label on a file. A LabelModification can be used to apply a label to a file, update an existing label on a file, or remove a label from a file.

func (LabelModification) MarshalJSON added in v0.88.0

func (s LabelModification) MarshalJSON() ([]byte, error)

type ModifyLabelsRequest added in v0.88.0

type ModifyLabelsRequest struct {
	// Kind: This is always drive#modifyLabelsRequest.
	Kind string `json:"kind,omitempty"`
	// LabelModifications: The list of modifications to apply to the labels on the
	// file.
	LabelModifications []*LabelModification `json:"labelModifications,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ModifyLabelsRequest: A request to modify the set of labels on a file. This request may contain many modifications that will either all succeed or all fail atomically.

func (ModifyLabelsRequest) MarshalJSON added in v0.88.0

func (s ModifyLabelsRequest) MarshalJSON() ([]byte, error)

type ModifyLabelsResponse added in v0.88.0

type ModifyLabelsResponse struct {
	// Kind: This is always drive#modifyLabelsResponse
	Kind string `json:"kind,omitempty"`
	// ModifiedLabels: The list of labels which were added or updated by the
	// request.
	ModifiedLabels []*Label `json:"modifiedLabels,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ModifyLabelsResponse: Response to a ModifyLabels request. This contains only those labels which were added or updated by the request.

func (ModifyLabelsResponse) MarshalJSON added in v0.88.0

func (s ModifyLabelsResponse) MarshalJSON() ([]byte, error)

type Permission

type Permission struct {
	// AllowFileDiscovery: Whether the permission allows the file to be discovered
	// through search. This is only applicable for permissions of type `domain` or
	// `anyone`.
	AllowFileDiscovery bool `json:"allowFileDiscovery,omitempty"`
	// Deleted: Output only. Whether the account associated with this permission
	// has been deleted. This field only pertains to user and group permissions.
	Deleted bool `json:"deleted,omitempty"`
	// DisplayName: Output only. The "pretty" name of the value of the permission.
	// The following is a list of examples for each type of permission: * `user` -
	// User's full name, as defined for their Google account, such as "Joe Smith."
	// * `group` - Name of the Google Group, such as "The Company Administrators."
	// * `domain` - String domain name, such as "thecompany.com." * `anyone` - No
	// `displayName` is present.
	DisplayName string `json:"displayName,omitempty"`
	// Domain: The domain to which this permission refers.
	Domain string `json:"domain,omitempty"`
	// EmailAddress: The email address of the user or group to which this
	// permission refers.
	EmailAddress string `json:"emailAddress,omitempty"`
	// ExpirationTime: The time at which this permission will expire (RFC 3339
	// date-time). Expiration times have the following restrictions: - They can
	// only be set on user and group permissions - The time must be in the future -
	// The time cannot be more than a year in the future
	ExpirationTime string `json:"expirationTime,omitempty"`
	// Id: Output only. The ID of this permission. This is a unique identifier for
	// the grantee, and is published in User resources as `permissionId`. IDs
	// should be treated as opaque values.
	Id string `json:"id,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#permission".
	Kind string `json:"kind,omitempty"`
	// PendingOwner: Whether the account associated with this permission is a
	// pending owner. Only populated for `user` type permissions for files that are
	// not in a shared drive.
	PendingOwner bool `json:"pendingOwner,omitempty"`
	// PermissionDetails: Output only. Details of whether the permissions on this
	// shared drive item are inherited or directly on this item. This is an
	// output-only field which is present only for shared drive items.
	PermissionDetails []*PermissionPermissionDetails `json:"permissionDetails,omitempty"`
	// PhotoLink: Output only. A link to the user's profile photo, if available.
	PhotoLink string `json:"photoLink,omitempty"`
	// Role: The role granted by this permission. While new values may be supported
	// in the future, the following are currently allowed: * `owner` * `organizer`
	// * `fileOrganizer` * `writer` * `commenter` * `reader`
	Role string `json:"role,omitempty"`
	// TeamDrivePermissionDetails: Output only. Deprecated: Output only. Use
	// `permissionDetails` instead.
	TeamDrivePermissionDetails []*PermissionTeamDrivePermissionDetails `json:"teamDrivePermissionDetails,omitempty"`
	// Type: The type of the grantee. Valid values are: * `user` * `group` *
	// `domain` * `anyone` When creating a permission, if `type` is `user` or
	// `group`, you must provide an `emailAddress` for the user or group. When
	// `type` is `domain`, you must provide a `domain`. There isn't extra
	// information required for an `anyone` type.
	Type string `json:"type,omitempty"`
	// View: Indicates the view for this permission. Only populated for permissions
	// that belong to a view. 'published' is the only supported value.
	View string `json:"view,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AllowFileDiscovery") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AllowFileDiscovery") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Permission: A permission for a file. A permission grants a user, group, domain, or the world access to a file or a folder hierarchy. Some resource methods (such as `permissions.update`) require a `permissionId`. Use the `permissions.list` method to retrieve the ID for a file, folder, or shared drive.

func (Permission) MarshalJSON

func (s Permission) MarshalJSON() ([]byte, error)

type PermissionList

type PermissionList struct {
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#permissionList".
	Kind string `json:"kind,omitempty"`
	// NextPageToken: The page token for the next page of permissions. This field
	// will be absent if the end of the permissions list has been reached. If the
	// token is rejected for any reason, it should be discarded, and pagination
	// should be restarted from the first page of results. The page token is
	// typically valid for several hours. However, if new items are added or
	// removed, your expected results might differ.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Permissions: The list of permissions. If nextPageToken is populated, then
	// this list may be incomplete and an additional page of results should be
	// fetched.
	Permissions []*Permission `json:"permissions,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

PermissionList: A list of permissions for a file.

func (PermissionList) MarshalJSON

func (s PermissionList) MarshalJSON() ([]byte, error)

type PermissionPermissionDetails added in v0.4.0

type PermissionPermissionDetails struct {
	// Inherited: Output only. Whether this permission is inherited. This field is
	// always populated. This is an output-only field.
	Inherited bool `json:"inherited,omitempty"`
	// InheritedFrom: Output only. The ID of the item from which this permission is
	// inherited. This is an output-only field.
	InheritedFrom string `json:"inheritedFrom,omitempty"`
	// PermissionType: Output only. The permission type for this user. While new
	// values may be added in future, the following are currently possible: *
	// `file` * `member`
	PermissionType string `json:"permissionType,omitempty"`
	// Role: Output only. The primary role for this user. While new values may be
	// added in the future, the following are currently possible: * `organizer` *
	// `fileOrganizer` * `writer` * `commenter` * `reader`
	Role string `json:"role,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Inherited") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Inherited") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (PermissionPermissionDetails) MarshalJSON added in v0.4.0

func (s PermissionPermissionDetails) MarshalJSON() ([]byte, error)

type PermissionTeamDrivePermissionDetails

type PermissionTeamDrivePermissionDetails struct {
	// Inherited: Deprecated: Output only. Use `permissionDetails/inherited`
	// instead.
	Inherited bool `json:"inherited,omitempty"`
	// InheritedFrom: Deprecated: Output only. Use
	// `permissionDetails/inheritedFrom` instead.
	InheritedFrom string `json:"inheritedFrom,omitempty"`
	// Role: Deprecated: Output only. Use `permissionDetails/role` instead.
	Role string `json:"role,omitempty"`
	// TeamDrivePermissionType: Deprecated: Output only. Use
	// `permissionDetails/permissionType` instead.
	TeamDrivePermissionType string `json:"teamDrivePermissionType,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Inherited") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Inherited") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (PermissionTeamDrivePermissionDetails) MarshalJSON

func (s PermissionTeamDrivePermissionDetails) MarshalJSON() ([]byte, error)

type PermissionsCreateCall

type PermissionsCreateCall struct {
	// contains filtered or unexported fields
}

func (*PermissionsCreateCall) Context

Context sets the context to be used in this call's Do method.

func (*PermissionsCreateCall) Do

Do executes the "drive.permissions.create" call. Any non-2xx status code is an error. Response headers are in either *Permission.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 (*PermissionsCreateCall) EmailMessage

func (c *PermissionsCreateCall) EmailMessage(emailMessage string) *PermissionsCreateCall

EmailMessage sets the optional parameter "emailMessage": A plain text custom message to include in the notification email.

func (*PermissionsCreateCall) EnforceSingleParent added in v0.21.0

func (c *PermissionsCreateCall) EnforceSingleParent(enforceSingleParent bool) *PermissionsCreateCall

EnforceSingleParent sets the optional parameter "enforceSingleParent": Deprecated: See `moveToNewOwnersRoot` for details.

func (*PermissionsCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*PermissionsCreateCall) Header

func (c *PermissionsCreateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*PermissionsCreateCall) MoveToNewOwnersRoot added in v0.21.0

func (c *PermissionsCreateCall) MoveToNewOwnersRoot(moveToNewOwnersRoot bool) *PermissionsCreateCall

MoveToNewOwnersRoot sets the optional parameter "moveToNewOwnersRoot": This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents are not changed.

func (*PermissionsCreateCall) SendNotificationEmail

func (c *PermissionsCreateCall) SendNotificationEmail(sendNotificationEmail bool) *PermissionsCreateCall

SendNotificationEmail sets the optional parameter "sendNotificationEmail": Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.

func (*PermissionsCreateCall) SupportsAllDrives added in v0.4.0

func (c *PermissionsCreateCall) SupportsAllDrives(supportsAllDrives bool) *PermissionsCreateCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*PermissionsCreateCall) SupportsTeamDrives

func (c *PermissionsCreateCall) SupportsTeamDrives(supportsTeamDrives bool) *PermissionsCreateCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*PermissionsCreateCall) TransferOwnership

func (c *PermissionsCreateCall) TransferOwnership(transferOwnership bool) *PermissionsCreateCall

TransferOwnership sets the optional parameter "transferOwnership": Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.

func (*PermissionsCreateCall) UseDomainAdminAccess

func (c *PermissionsCreateCall) UseDomainAdminAccess(useDomainAdminAccess bool) *PermissionsCreateCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

type PermissionsDeleteCall

type PermissionsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*PermissionsDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*PermissionsDeleteCall) Do

Do executes the "drive.permissions.delete" call.

func (*PermissionsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*PermissionsDeleteCall) Header

func (c *PermissionsDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*PermissionsDeleteCall) SupportsAllDrives added in v0.4.0

func (c *PermissionsDeleteCall) SupportsAllDrives(supportsAllDrives bool) *PermissionsDeleteCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*PermissionsDeleteCall) SupportsTeamDrives

func (c *PermissionsDeleteCall) SupportsTeamDrives(supportsTeamDrives bool) *PermissionsDeleteCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*PermissionsDeleteCall) UseDomainAdminAccess

func (c *PermissionsDeleteCall) UseDomainAdminAccess(useDomainAdminAccess bool) *PermissionsDeleteCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

type PermissionsGetCall

type PermissionsGetCall struct {
	// contains filtered or unexported fields
}

func (*PermissionsGetCall) Context

Context sets the context to be used in this call's Do method.

func (*PermissionsGetCall) Do

Do executes the "drive.permissions.get" call. Any non-2xx status code is an error. Response headers are in either *Permission.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 (*PermissionsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*PermissionsGetCall) Header

func (c *PermissionsGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*PermissionsGetCall) IfNoneMatch

func (c *PermissionsGetCall) IfNoneMatch(entityTag string) *PermissionsGetCall

IfNoneMatch sets an 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.

func (*PermissionsGetCall) SupportsAllDrives added in v0.4.0

func (c *PermissionsGetCall) SupportsAllDrives(supportsAllDrives bool) *PermissionsGetCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*PermissionsGetCall) SupportsTeamDrives

func (c *PermissionsGetCall) SupportsTeamDrives(supportsTeamDrives bool) *PermissionsGetCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*PermissionsGetCall) UseDomainAdminAccess

func (c *PermissionsGetCall) UseDomainAdminAccess(useDomainAdminAccess bool) *PermissionsGetCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

type PermissionsListCall

type PermissionsListCall struct {
	// contains filtered or unexported fields
}

func (*PermissionsListCall) Context

Context sets the context to be used in this call's Do method.

func (*PermissionsListCall) Do

Do executes the "drive.permissions.list" call. Any non-2xx status code is an error. Response headers are in either *PermissionList.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 (*PermissionsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*PermissionsListCall) Header

func (c *PermissionsListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*PermissionsListCall) IfNoneMatch

func (c *PermissionsListCall) IfNoneMatch(entityTag string) *PermissionsListCall

IfNoneMatch sets an 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.

func (*PermissionsListCall) IncludePermissionsForView added in v0.31.0

func (c *PermissionsListCall) IncludePermissionsForView(includePermissionsForView string) *PermissionsListCall

IncludePermissionsForView sets the optional parameter "includePermissionsForView": Specifies which additional view's permissions to include in the response. Only 'published' is supported.

func (*PermissionsListCall) PageSize

func (c *PermissionsListCall) PageSize(pageSize int64) *PermissionsListCall

PageSize sets the optional parameter "pageSize": The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned.

func (*PermissionsListCall) PageToken

func (c *PermissionsListCall) PageToken(pageToken string) *PermissionsListCall

PageToken sets the optional parameter "pageToken": The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

func (*PermissionsListCall) Pages

func (c *PermissionsListCall) Pages(ctx context.Context, f func(*PermissionList) error) error

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 (*PermissionsListCall) SupportsAllDrives added in v0.4.0

func (c *PermissionsListCall) SupportsAllDrives(supportsAllDrives bool) *PermissionsListCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*PermissionsListCall) SupportsTeamDrives

func (c *PermissionsListCall) SupportsTeamDrives(supportsTeamDrives bool) *PermissionsListCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*PermissionsListCall) UseDomainAdminAccess

func (c *PermissionsListCall) UseDomainAdminAccess(useDomainAdminAccess bool) *PermissionsListCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

type PermissionsService

type PermissionsService struct {
	// contains filtered or unexported fields
}

func NewPermissionsService

func NewPermissionsService(s *Service) *PermissionsService

func (*PermissionsService) Create

func (r *PermissionsService) Create(fileId string, permission *Permission) *PermissionsCreateCall

Create: Creates a permission for a file or shared drive. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.

- fileId: The ID of the file or shared drive.

func (*PermissionsService) Delete

func (r *PermissionsService) Delete(fileId string, permissionId string) *PermissionsDeleteCall

Delete: Deletes a permission. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.

- fileId: The ID of the file or shared drive. - permissionId: The ID of the permission.

func (*PermissionsService) Get

func (r *PermissionsService) Get(fileId string, permissionId string) *PermissionsGetCall

Get: Gets a permission by ID.

- fileId: The ID of the file. - permissionId: The ID of the permission.

func (*PermissionsService) List

List: Lists a file's or shared drive's permissions.

- fileId: The ID of the file or shared drive.

func (*PermissionsService) Update

func (r *PermissionsService) Update(fileId string, permissionId string, permission *Permission) *PermissionsUpdateCall

Update: Updates a permission with patch semantics. **Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.

- fileId: The ID of the file or shared drive. - permissionId: The ID of the permission.

type PermissionsUpdateCall

type PermissionsUpdateCall struct {
	// contains filtered or unexported fields
}

func (*PermissionsUpdateCall) Context

Context sets the context to be used in this call's Do method.

func (*PermissionsUpdateCall) Do

Do executes the "drive.permissions.update" call. Any non-2xx status code is an error. Response headers are in either *Permission.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 (*PermissionsUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*PermissionsUpdateCall) Header

func (c *PermissionsUpdateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*PermissionsUpdateCall) RemoveExpiration

func (c *PermissionsUpdateCall) RemoveExpiration(removeExpiration bool) *PermissionsUpdateCall

RemoveExpiration sets the optional parameter "removeExpiration": Whether to remove the expiration date.

func (*PermissionsUpdateCall) SupportsAllDrives added in v0.4.0

func (c *PermissionsUpdateCall) SupportsAllDrives(supportsAllDrives bool) *PermissionsUpdateCall

SupportsAllDrives sets the optional parameter "supportsAllDrives": Whether the requesting application supports both My Drives and shared drives.

func (*PermissionsUpdateCall) SupportsTeamDrives

func (c *PermissionsUpdateCall) SupportsTeamDrives(supportsTeamDrives bool) *PermissionsUpdateCall

SupportsTeamDrives sets the optional parameter "supportsTeamDrives": Deprecated: Use `supportsAllDrives` instead.

func (*PermissionsUpdateCall) TransferOwnership

func (c *PermissionsUpdateCall) TransferOwnership(transferOwnership bool) *PermissionsUpdateCall

TransferOwnership sets the optional parameter "transferOwnership": Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.

func (*PermissionsUpdateCall) UseDomainAdminAccess

func (c *PermissionsUpdateCall) UseDomainAdminAccess(useDomainAdminAccess bool) *PermissionsUpdateCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

type RepliesCreateCall

type RepliesCreateCall struct {
	// contains filtered or unexported fields
}

func (*RepliesCreateCall) Context

Context sets the context to be used in this call's Do method.

func (*RepliesCreateCall) Do

func (c *RepliesCreateCall) Do(opts ...googleapi.CallOption) (*Reply, error)

Do executes the "drive.replies.create" call. Any non-2xx status code is an error. Response headers are in either *Reply.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 (*RepliesCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RepliesCreateCall) Header

func (c *RepliesCreateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type RepliesDeleteCall

type RepliesDeleteCall struct {
	// contains filtered or unexported fields
}

func (*RepliesDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*RepliesDeleteCall) Do

Do executes the "drive.replies.delete" call.

func (*RepliesDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RepliesDeleteCall) Header

func (c *RepliesDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type RepliesGetCall

type RepliesGetCall struct {
	// contains filtered or unexported fields
}

func (*RepliesGetCall) Context

func (c *RepliesGetCall) Context(ctx context.Context) *RepliesGetCall

Context sets the context to be used in this call's Do method.

func (*RepliesGetCall) Do

func (c *RepliesGetCall) Do(opts ...googleapi.CallOption) (*Reply, error)

Do executes the "drive.replies.get" call. Any non-2xx status code is an error. Response headers are in either *Reply.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 (*RepliesGetCall) Fields

func (c *RepliesGetCall) Fields(s ...googleapi.Field) *RepliesGetCall

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RepliesGetCall) Header

func (c *RepliesGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*RepliesGetCall) IfNoneMatch

func (c *RepliesGetCall) IfNoneMatch(entityTag string) *RepliesGetCall

IfNoneMatch sets an 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.

func (*RepliesGetCall) IncludeDeleted

func (c *RepliesGetCall) IncludeDeleted(includeDeleted bool) *RepliesGetCall

IncludeDeleted sets the optional parameter "includeDeleted": Whether to return deleted replies. Deleted replies will not include their original content.

type RepliesListCall

type RepliesListCall struct {
	// contains filtered or unexported fields
}

func (*RepliesListCall) Context

Context sets the context to be used in this call's Do method.

func (*RepliesListCall) Do

func (c *RepliesListCall) Do(opts ...googleapi.CallOption) (*ReplyList, error)

Do executes the "drive.replies.list" call. Any non-2xx status code is an error. Response headers are in either *ReplyList.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 (*RepliesListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RepliesListCall) Header

func (c *RepliesListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*RepliesListCall) IfNoneMatch

func (c *RepliesListCall) IfNoneMatch(entityTag string) *RepliesListCall

IfNoneMatch sets an 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.

func (*RepliesListCall) IncludeDeleted

func (c *RepliesListCall) IncludeDeleted(includeDeleted bool) *RepliesListCall

IncludeDeleted sets the optional parameter "includeDeleted": Whether to include deleted replies. Deleted replies will not include their original content.

func (*RepliesListCall) PageSize

func (c *RepliesListCall) PageSize(pageSize int64) *RepliesListCall

PageSize sets the optional parameter "pageSize": The maximum number of replies to return per page.

func (*RepliesListCall) PageToken

func (c *RepliesListCall) PageToken(pageToken string) *RepliesListCall

PageToken sets the optional parameter "pageToken": The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

func (*RepliesListCall) Pages

func (c *RepliesListCall) Pages(ctx context.Context, f func(*ReplyList) error) error

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.

type RepliesService

type RepliesService struct {
	// contains filtered or unexported fields
}

func NewRepliesService

func NewRepliesService(s *Service) *RepliesService

func (*RepliesService) Create

func (r *RepliesService) Create(fileId string, commentId string, reply *Reply) *RepliesCreateCall

Create: Creates a reply to a comment.

- commentId: The ID of the comment. - fileId: The ID of the file.

func (*RepliesService) Delete

func (r *RepliesService) Delete(fileId string, commentId string, replyId string) *RepliesDeleteCall

Delete: Deletes a reply.

- commentId: The ID of the comment. - fileId: The ID of the file. - replyId: The ID of the reply.

func (*RepliesService) Get

func (r *RepliesService) Get(fileId string, commentId string, replyId string) *RepliesGetCall

Get: Gets a reply by ID.

- commentId: The ID of the comment. - fileId: The ID of the file. - replyId: The ID of the reply.

func (*RepliesService) List

func (r *RepliesService) List(fileId string, commentId string) *RepliesListCall

List: Lists a comment's replies.

- commentId: The ID of the comment. - fileId: The ID of the file.

func (*RepliesService) Update

func (r *RepliesService) Update(fileId string, commentId string, replyId string, reply *Reply) *RepliesUpdateCall

Update: Updates a reply with patch semantics.

- commentId: The ID of the comment. - fileId: The ID of the file. - replyId: The ID of the reply.

type RepliesUpdateCall

type RepliesUpdateCall struct {
	// contains filtered or unexported fields
}

func (*RepliesUpdateCall) Context

Context sets the context to be used in this call's Do method.

func (*RepliesUpdateCall) Do

func (c *RepliesUpdateCall) Do(opts ...googleapi.CallOption) (*Reply, error)

Do executes the "drive.replies.update" call. Any non-2xx status code is an error. Response headers are in either *Reply.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 (*RepliesUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RepliesUpdateCall) Header

func (c *RepliesUpdateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type Reply

type Reply struct {
	// Action: The action the reply performed to the parent comment. Valid values
	// are: * `resolve` * `reopen`
	Action string `json:"action,omitempty"`
	// Author: Output only. The author of the reply. The author's email address and
	// permission ID will not be populated.
	Author *User `json:"author,omitempty"`
	// Content: The plain text content of the reply. This field is used for setting
	// the content, while `htmlContent` should be displayed. This is required on
	// creates if no `action` is specified.
	Content string `json:"content,omitempty"`
	// CreatedTime: The time at which the reply was created (RFC 3339 date-time).
	CreatedTime string `json:"createdTime,omitempty"`
	// Deleted: Output only. Whether the reply has been deleted. A deleted reply
	// has no content.
	Deleted bool `json:"deleted,omitempty"`
	// HtmlContent: Output only. The content of the reply with HTML formatting.
	HtmlContent string `json:"htmlContent,omitempty"`
	// Id: Output only. The ID of the reply.
	Id string `json:"id,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#reply".
	Kind string `json:"kind,omitempty"`
	// ModifiedTime: The last time the reply was modified (RFC 3339 date-time).
	ModifiedTime string `json:"modifiedTime,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Action") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Action") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Reply: A reply to a comment on a file. Some resource methods (such as `replies.update`) require a `replyId`. Use the `replies.list` method to retrieve the ID for a reply.

func (Reply) MarshalJSON

func (s Reply) MarshalJSON() ([]byte, error)

type ReplyList

type ReplyList struct {
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#replyList".
	Kind string `json:"kind,omitempty"`
	// NextPageToken: The page token for the next page of replies. This will be
	// absent if the end of the replies list has been reached. If the token is
	// rejected for any reason, it should be discarded, and pagination should be
	// restarted from the first page of results. The page token is typically valid
	// for several hours. However, if new items are added or removed, your expected
	// results might differ.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Replies: The list of replies. If nextPageToken is populated, then this list
	// may be incomplete and an additional page of results should be fetched.
	Replies []*Reply `json:"replies,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

ReplyList: A list of replies to a comment on a file.

func (ReplyList) MarshalJSON

func (s ReplyList) MarshalJSON() ([]byte, error)

type Revision

type Revision struct {
	// ExportLinks: Output only. Links for exporting Docs Editors files to specific
	// formats.
	ExportLinks map[string]string `json:"exportLinks,omitempty"`
	// Id: Output only. The ID of the revision.
	Id string `json:"id,omitempty"`
	// KeepForever: Whether to keep this revision forever, even if it is no longer
	// the head revision. If not set, the revision will be automatically purged 30
	// days after newer content is uploaded. This can be set on a maximum of 200
	// revisions for a file. This field is only applicable to files with binary
	// content in Drive.
	KeepForever bool `json:"keepForever,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#revision".
	Kind string `json:"kind,omitempty"`
	// LastModifyingUser: Output only. The last user to modify this revision. This
	// field is only populated when the last modification was performed by a
	// signed-in user.
	LastModifyingUser *User `json:"lastModifyingUser,omitempty"`
	// Md5Checksum: Output only. The MD5 checksum of the revision's content. This
	// is only applicable to files with binary content in Drive.
	Md5Checksum string `json:"md5Checksum,omitempty"`
	// MimeType: Output only. The MIME type of the revision.
	MimeType string `json:"mimeType,omitempty"`
	// ModifiedTime: The last time the revision was modified (RFC 3339 date-time).
	ModifiedTime string `json:"modifiedTime,omitempty"`
	// OriginalFilename: Output only. The original filename used to create this
	// revision. This is only applicable to files with binary content in Drive.
	OriginalFilename string `json:"originalFilename,omitempty"`
	// PublishAuto: Whether subsequent revisions will be automatically republished.
	// This is only applicable to Docs Editors files.
	PublishAuto bool `json:"publishAuto,omitempty"`
	// Published: Whether this revision is published. This is only applicable to
	// Docs Editors files.
	Published bool `json:"published,omitempty"`
	// PublishedLink: Output only. A link to the published revision. This is only
	// populated for Google Sites files.
	PublishedLink string `json:"publishedLink,omitempty"`
	// PublishedOutsideDomain: Whether this revision is published outside the
	// domain. This is only applicable to Docs Editors files.
	PublishedOutsideDomain bool `json:"publishedOutsideDomain,omitempty"`
	// Size: Output only. The size of the revision's content in bytes. This is only
	// applicable to files with binary content in Drive.
	Size int64 `json:"size,omitempty,string"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "ExportLinks") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "ExportLinks") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

Revision: The metadata for a revision to a file. Some resource methods (such as `revisions.update`) require a `revisionId`. Use the `revisions.list` method to retrieve the ID for a revision.

func (Revision) MarshalJSON

func (s Revision) MarshalJSON() ([]byte, error)

type RevisionList

type RevisionList struct {
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#revisionList".
	Kind string `json:"kind,omitempty"`
	// NextPageToken: The page token for the next page of revisions. This will be
	// absent if the end of the revisions list has been reached. If the token is
	// rejected for any reason, it should be discarded, and pagination should be
	// restarted from the first page of results. The page token is typically valid
	// for several hours. However, if new items are added or removed, your expected
	// results might differ.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// Revisions: The list of revisions. If nextPageToken is populated, then this
	// list may be incomplete and an additional page of results should be fetched.
	Revisions []*Revision `json:"revisions,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

RevisionList: A list of revisions of a file.

func (RevisionList) MarshalJSON

func (s RevisionList) MarshalJSON() ([]byte, error)

type RevisionsDeleteCall

type RevisionsDeleteCall struct {
	// contains filtered or unexported fields
}

func (*RevisionsDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*RevisionsDeleteCall) Do

Do executes the "drive.revisions.delete" call.

func (*RevisionsDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RevisionsDeleteCall) Header

func (c *RevisionsDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type RevisionsGetCall

type RevisionsGetCall struct {
	// contains filtered or unexported fields
}

func (*RevisionsGetCall) AcknowledgeAbuse

func (c *RevisionsGetCall) AcknowledgeAbuse(acknowledgeAbuse bool) *RevisionsGetCall

AcknowledgeAbuse sets the optional parameter "acknowledgeAbuse": Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides.

func (*RevisionsGetCall) Context

Context sets the context to be used in this call's Do and Download methods.

func (*RevisionsGetCall) Do

func (c *RevisionsGetCall) Do(opts ...googleapi.CallOption) (*Revision, error)

Do executes the "drive.revisions.get" call. Any non-2xx status code is an error. Response headers are in either *Revision.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 (*RevisionsGetCall) Download

func (c *RevisionsGetCall) Download(opts ...googleapi.CallOption) (*http.Response, error)

Download fetches the API endpoint's "media" value, instead of the normal API response value. If the returned error is nil, the Response is guaranteed to have a 2xx status code. Callers must close the Response.Body as usual.

func (*RevisionsGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RevisionsGetCall) Header

func (c *RevisionsGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*RevisionsGetCall) IfNoneMatch

func (c *RevisionsGetCall) IfNoneMatch(entityTag string) *RevisionsGetCall

IfNoneMatch sets an 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.

type RevisionsListCall

type RevisionsListCall struct {
	// contains filtered or unexported fields
}

func (*RevisionsListCall) Context

Context sets the context to be used in this call's Do method.

func (*RevisionsListCall) Do

Do executes the "drive.revisions.list" call. Any non-2xx status code is an error. Response headers are in either *RevisionList.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 (*RevisionsListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RevisionsListCall) Header

func (c *RevisionsListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*RevisionsListCall) IfNoneMatch

func (c *RevisionsListCall) IfNoneMatch(entityTag string) *RevisionsListCall

IfNoneMatch sets an 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.

func (*RevisionsListCall) PageSize

func (c *RevisionsListCall) PageSize(pageSize int64) *RevisionsListCall

PageSize sets the optional parameter "pageSize": The maximum number of revisions to return per page.

func (*RevisionsListCall) PageToken

func (c *RevisionsListCall) PageToken(pageToken string) *RevisionsListCall

PageToken sets the optional parameter "pageToken": The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

func (*RevisionsListCall) Pages

func (c *RevisionsListCall) Pages(ctx context.Context, f func(*RevisionList) error) error

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.

type RevisionsService

type RevisionsService struct {
	// contains filtered or unexported fields
}

func NewRevisionsService

func NewRevisionsService(s *Service) *RevisionsService

func (*RevisionsService) Delete

func (r *RevisionsService) Delete(fileId string, revisionId string) *RevisionsDeleteCall

Delete: Permanently deletes a file version. You can only delete revisions for files with binary content in Google Drive, like images or videos. Revisions for other files, like Google Docs or Sheets, and the last remaining file version can't be deleted.

- fileId: The ID of the file. - revisionId: The ID of the revision.

func (*RevisionsService) Get

func (r *RevisionsService) Get(fileId string, revisionId string) *RevisionsGetCall

Get: Gets a revision's metadata or content by ID.

- fileId: The ID of the file. - revisionId: The ID of the revision.

func (*RevisionsService) List

func (r *RevisionsService) List(fileId string) *RevisionsListCall

List: Lists a file's revisions.

- fileId: The ID of the file.

func (*RevisionsService) Update

func (r *RevisionsService) Update(fileId string, revisionId string, revision *Revision) *RevisionsUpdateCall

Update: Updates a revision with patch semantics.

- fileId: The ID of the file. - revisionId: The ID of the revision.

type RevisionsUpdateCall

type RevisionsUpdateCall struct {
	// contains filtered or unexported fields
}

func (*RevisionsUpdateCall) Context

Context sets the context to be used in this call's Do method.

func (*RevisionsUpdateCall) Do

Do executes the "drive.revisions.update" call. Any non-2xx status code is an error. Response headers are in either *Revision.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 (*RevisionsUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*RevisionsUpdateCall) Header

func (c *RevisionsUpdateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type Service

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	About *AboutService

	Apps *AppsService

	Changes *ChangesService

	Channels *ChannelsService

	Comments *CommentsService

	Drives *DrivesService

	Files *FilesService

	Permissions *PermissionsService

	Replies *RepliesService

	Revisions *RevisionsService

	Teamdrives *TeamdrivesService
	// contains filtered or unexported fields
}

func New deprecated

func New(client *http.Client) (*Service, error)

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.

func NewService added in v0.3.0

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

type StartPageToken

type StartPageToken struct {
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#startPageToken".
	Kind string `json:"kind,omitempty"`
	// StartPageToken: The starting page token for listing future changes. The page
	// token doesn't expire.
	StartPageToken string `json:"startPageToken,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

func (StartPageToken) MarshalJSON

func (s StartPageToken) MarshalJSON() ([]byte, error)

type TeamDrive

type TeamDrive struct {
	// BackgroundImageFile: An image file and cropping parameters from which a
	// background image for this Team Drive is set. This is a write only field; it
	// can only be set on `drive.teamdrives.update` requests that don't set
	// `themeId`. When specified, all fields of the `backgroundImageFile` must be
	// set.
	BackgroundImageFile *TeamDriveBackgroundImageFile `json:"backgroundImageFile,omitempty"`
	// BackgroundImageLink: A short-lived link to this Team Drive's background
	// image.
	BackgroundImageLink string `json:"backgroundImageLink,omitempty"`
	// Capabilities: Capabilities the current user has on this Team Drive.
	Capabilities *TeamDriveCapabilities `json:"capabilities,omitempty"`
	// ColorRgb: The color of this Team Drive as an RGB hex string. It can only be
	// set on a `drive.teamdrives.update` request that does not set `themeId`.
	ColorRgb string `json:"colorRgb,omitempty"`
	// CreatedTime: The time at which the Team Drive was created (RFC 3339
	// date-time).
	CreatedTime string `json:"createdTime,omitempty"`
	// Id: The ID of this Team Drive which is also the ID of the top level folder
	// of this Team Drive.
	Id string `json:"id,omitempty"`
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#teamDrive".
	Kind string `json:"kind,omitempty"`
	// Name: The name of this Team Drive.
	Name string `json:"name,omitempty"`
	// OrgUnitId: The organizational unit of this shared drive. This field is only
	// populated on `drives.list` responses when the `useDomainAdminAccess`
	// parameter is set to `true`.
	OrgUnitId string `json:"orgUnitId,omitempty"`
	// Restrictions: A set of restrictions that apply to this Team Drive or items
	// inside this Team Drive.
	Restrictions *TeamDriveRestrictions `json:"restrictions,omitempty"`
	// ThemeId: The ID of the theme from which the background image and color will
	// be set. The set of possible `teamDriveThemes` can be retrieved from a
	// `drive.about.get` response. When not specified on a
	// `drive.teamdrives.create` request, a random theme is chosen from which the
	// background image and color are set. This is a write-only field; it can only
	// be set on requests that don't set `colorRgb` or `backgroundImageFile`.
	ThemeId string `json:"themeId,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "BackgroundImageFile") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "BackgroundImageFile") to include
	// in API requests with the JSON null value. By default, fields with empty
	// values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TeamDrive: Deprecated: use the drive collection instead.

func (TeamDrive) MarshalJSON

func (s TeamDrive) MarshalJSON() ([]byte, error)

type TeamDriveBackgroundImageFile

type TeamDriveBackgroundImageFile struct {
	// Id: The ID of an image file in Drive to use for the background image.
	Id string `json:"id,omitempty"`
	// Width: The width of the cropped image in the closed range of 0 to 1. This
	// value represents the width of the cropped image divided by the width of the
	// entire image. The height is computed by applying a width to height aspect
	// ratio of 80 to 9. The resulting image must be at least 1280 pixels wide and
	// 144 pixels high.
	Width float64 `json:"width,omitempty"`
	// XCoordinate: The X coordinate of the upper left corner of the cropping area
	// in the background image. This is a value in the closed range of 0 to 1. This
	// value represents the horizontal distance from the left side of the entire
	// image to the left side of the cropping area divided by the width of the
	// entire image.
	XCoordinate float64 `json:"xCoordinate,omitempty"`
	// YCoordinate: The Y coordinate of the upper left corner of the cropping area
	// in the background image. This is a value in the closed range of 0 to 1. This
	// value represents the vertical distance from the top side of the entire image
	// to the top side of the cropping area divided by the height of the entire
	// image.
	YCoordinate float64 `json:"yCoordinate,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Id") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	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. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TeamDriveBackgroundImageFile: An image file and cropping parameters from which a background image for this Team Drive is set. This is a write only field; it can only be set on `drive.teamdrives.update` requests that don't set `themeId`. When specified, all fields of the `backgroundImageFile` must be set.

func (TeamDriveBackgroundImageFile) MarshalJSON

func (s TeamDriveBackgroundImageFile) MarshalJSON() ([]byte, error)

func (*TeamDriveBackgroundImageFile) UnmarshalJSON

func (s *TeamDriveBackgroundImageFile) UnmarshalJSON(data []byte) error

type TeamDriveCapabilities

type TeamDriveCapabilities struct {
	// CanAddChildren: Whether the current user can add children to folders in this
	// Team Drive.
	CanAddChildren bool `json:"canAddChildren,omitempty"`
	// CanChangeCopyRequiresWriterPermissionRestriction: Whether the current user
	// can change the `copyRequiresWriterPermission` restriction of this Team
	// Drive.
	CanChangeCopyRequiresWriterPermissionRestriction bool `json:"canChangeCopyRequiresWriterPermissionRestriction,omitempty"`
	// CanChangeDomainUsersOnlyRestriction: Whether the current user can change the
	// `domainUsersOnly` restriction of this Team Drive.
	CanChangeDomainUsersOnlyRestriction bool `json:"canChangeDomainUsersOnlyRestriction,omitempty"`
	// CanChangeSharingFoldersRequiresOrganizerPermissionRestriction: Whether the
	// current user can change the `sharingFoldersRequiresOrganizerPermission`
	// restriction of this Team Drive.
	CanChangeSharingFoldersRequiresOrganizerPermissionRestriction bool `json:"canChangeSharingFoldersRequiresOrganizerPermissionRestriction,omitempty"`
	// CanChangeTeamDriveBackground: Whether the current user can change the
	// background of this Team Drive.
	CanChangeTeamDriveBackground bool `json:"canChangeTeamDriveBackground,omitempty"`
	// CanChangeTeamMembersOnlyRestriction: Whether the current user can change the
	// `teamMembersOnly` restriction of this Team Drive.
	CanChangeTeamMembersOnlyRestriction bool `json:"canChangeTeamMembersOnlyRestriction,omitempty"`
	// CanComment: Whether the current user can comment on files in this Team
	// Drive.
	CanComment bool `json:"canComment,omitempty"`
	// CanCopy: Whether the current user can copy files in this Team Drive.
	CanCopy bool `json:"canCopy,omitempty"`
	// CanDeleteChildren: Whether the current user can delete children from folders
	// in this Team Drive.
	CanDeleteChildren bool `json:"canDeleteChildren,omitempty"`
	// CanDeleteTeamDrive: Whether the current user can delete this Team Drive.
	// Attempting to delete the Team Drive may still fail if there are untrashed
	// items inside the Team Drive.
	CanDeleteTeamDrive bool `json:"canDeleteTeamDrive,omitempty"`
	// CanDownload: Whether the current user can download files in this Team Drive.
	CanDownload bool `json:"canDownload,omitempty"`
	// CanEdit: Whether the current user can edit files in this Team Drive
	CanEdit bool `json:"canEdit,omitempty"`
	// CanListChildren: Whether the current user can list the children of folders
	// in this Team Drive.
	CanListChildren bool `json:"canListChildren,omitempty"`
	// CanManageMembers: Whether the current user can add members to this Team
	// Drive or remove them or change their role.
	CanManageMembers bool `json:"canManageMembers,omitempty"`
	// CanReadRevisions: Whether the current user can read the revisions resource
	// of files in this Team Drive.
	CanReadRevisions bool `json:"canReadRevisions,omitempty"`
	// CanRemoveChildren: Deprecated: Use `canDeleteChildren` or `canTrashChildren`
	// instead.
	CanRemoveChildren bool `json:"canRemoveChildren,omitempty"`
	// CanRename: Whether the current user can rename files or folders in this Team
	// Drive.
	CanRename bool `json:"canRename,omitempty"`
	// CanRenameTeamDrive: Whether the current user can rename this Team Drive.
	CanRenameTeamDrive bool `json:"canRenameTeamDrive,omitempty"`
	// CanResetTeamDriveRestrictions: Whether the current user can reset the Team
	// Drive restrictions to defaults.
	CanResetTeamDriveRestrictions bool `json:"canResetTeamDriveRestrictions,omitempty"`
	// CanShare: Whether the current user can share files or folders in this Team
	// Drive.
	CanShare bool `json:"canShare,omitempty"`
	// CanTrashChildren: Whether the current user can trash children from folders
	// in this Team Drive.
	CanTrashChildren bool `json:"canTrashChildren,omitempty"`
	// ForceSendFields is a list of field names (e.g. "CanAddChildren") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "CanAddChildren") to include in
	// API requests with the JSON null value. By default, fields with empty values
	// are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TeamDriveCapabilities: Capabilities the current user has on this Team Drive.

func (TeamDriveCapabilities) MarshalJSON

func (s TeamDriveCapabilities) MarshalJSON() ([]byte, error)

type TeamDriveList

type TeamDriveList struct {
	// Kind: Identifies what kind of resource this is. Value: the fixed string
	// "drive#teamDriveList".
	Kind string `json:"kind,omitempty"`
	// NextPageToken: The page token for the next page of Team Drives. This will be
	// absent if the end of the Team Drives list has been reached. If the token is
	// rejected for any reason, it should be discarded, and pagination should be
	// restarted from the first page of results. The page token is typically valid
	// for several hours. However, if new items are added or removed, your expected
	// results might differ.
	NextPageToken string `json:"nextPageToken,omitempty"`
	// TeamDrives: The list of Team Drives. If nextPageToken is populated, then
	// this list may be incomplete and an additional page of results should be
	// fetched.
	TeamDrives []*TeamDrive `json:"teamDrives,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Kind") to unconditionally
	// include in API requests. By default, fields with empty or default values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "Kind") to include in API requests
	// with the JSON null value. By default, fields with empty values are omitted
	// from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TeamDriveList: A list of Team Drives.

func (TeamDriveList) MarshalJSON

func (s TeamDriveList) MarshalJSON() ([]byte, error)

type TeamDriveRestrictions

type TeamDriveRestrictions struct {
	// AdminManagedRestrictions: Whether administrative privileges on this Team
	// Drive are required to modify restrictions.
	AdminManagedRestrictions bool `json:"adminManagedRestrictions,omitempty"`
	// CopyRequiresWriterPermission: Whether the options to copy, print, or
	// download files inside this Team Drive, should be disabled for readers and
	// commenters. When this restriction is set to `true`, it will override the
	// similarly named field to `true` for any file inside this Team Drive.
	CopyRequiresWriterPermission bool `json:"copyRequiresWriterPermission,omitempty"`
	// DomainUsersOnly: Whether access to this Team Drive and items inside this
	// Team Drive is restricted to users of the domain to which this Team Drive
	// belongs. This restriction may be overridden by other sharing policies
	// controlled outside of this Team Drive.
	DomainUsersOnly bool `json:"domainUsersOnly,omitempty"`
	// SharingFoldersRequiresOrganizerPermission: If true, only users with the
	// organizer role can share folders. If false, users with either the organizer
	// role or the file organizer role can share folders.
	SharingFoldersRequiresOrganizerPermission bool `json:"sharingFoldersRequiresOrganizerPermission,omitempty"`
	// TeamMembersOnly: Whether access to items inside this Team Drive is
	// restricted to members of this Team Drive.
	TeamMembersOnly bool `json:"teamMembersOnly,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AdminManagedRestrictions")
	// to unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "AdminManagedRestrictions") to
	// include in API requests with the JSON null value. By default, fields with
	// empty values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

TeamDriveRestrictions: A set of restrictions that apply to this Team Drive or items inside this Team Drive.

func (TeamDriveRestrictions) MarshalJSON

func (s TeamDriveRestrictions) MarshalJSON() ([]byte, error)

type TeamdrivesCreateCall

type TeamdrivesCreateCall struct {
	// contains filtered or unexported fields
}

func (*TeamdrivesCreateCall) Context

Context sets the context to be used in this call's Do method.

func (*TeamdrivesCreateCall) Do

Do executes the "drive.teamdrives.create" call. Any non-2xx status code is an error. Response headers are in either *TeamDrive.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 (*TeamdrivesCreateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TeamdrivesCreateCall) Header

func (c *TeamdrivesCreateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TeamdrivesDeleteCall

type TeamdrivesDeleteCall struct {
	// contains filtered or unexported fields
}

func (*TeamdrivesDeleteCall) Context

Context sets the context to be used in this call's Do method.

func (*TeamdrivesDeleteCall) Do

Do executes the "drive.teamdrives.delete" call.

func (*TeamdrivesDeleteCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TeamdrivesDeleteCall) Header

func (c *TeamdrivesDeleteCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

type TeamdrivesGetCall

type TeamdrivesGetCall struct {
	// contains filtered or unexported fields
}

func (*TeamdrivesGetCall) Context

Context sets the context to be used in this call's Do method.

func (*TeamdrivesGetCall) Do

Do executes the "drive.teamdrives.get" call. Any non-2xx status code is an error. Response headers are in either *TeamDrive.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 (*TeamdrivesGetCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TeamdrivesGetCall) Header

func (c *TeamdrivesGetCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TeamdrivesGetCall) IfNoneMatch

func (c *TeamdrivesGetCall) IfNoneMatch(entityTag string) *TeamdrivesGetCall

IfNoneMatch sets an 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.

func (*TeamdrivesGetCall) UseDomainAdminAccess

func (c *TeamdrivesGetCall) UseDomainAdminAccess(useDomainAdminAccess bool) *TeamdrivesGetCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.

type TeamdrivesListCall

type TeamdrivesListCall struct {
	// contains filtered or unexported fields
}

func (*TeamdrivesListCall) Context

Context sets the context to be used in this call's Do method.

func (*TeamdrivesListCall) Do

Do executes the "drive.teamdrives.list" call. Any non-2xx status code is an error. Response headers are in either *TeamDriveList.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 (*TeamdrivesListCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TeamdrivesListCall) Header

func (c *TeamdrivesListCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TeamdrivesListCall) IfNoneMatch

func (c *TeamdrivesListCall) IfNoneMatch(entityTag string) *TeamdrivesListCall

IfNoneMatch sets an 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.

func (*TeamdrivesListCall) PageSize

func (c *TeamdrivesListCall) PageSize(pageSize int64) *TeamdrivesListCall

PageSize sets the optional parameter "pageSize": Maximum number of Team Drives to return.

func (*TeamdrivesListCall) PageToken

func (c *TeamdrivesListCall) PageToken(pageToken string) *TeamdrivesListCall

PageToken sets the optional parameter "pageToken": Page token for Team Drives.

func (*TeamdrivesListCall) Pages

func (c *TeamdrivesListCall) Pages(ctx context.Context, f func(*TeamDriveList) error) error

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 (*TeamdrivesListCall) Q

Q sets the optional parameter "q": Query string for searching Team Drives.

func (*TeamdrivesListCall) UseDomainAdminAccess

func (c *TeamdrivesListCall) UseDomainAdminAccess(useDomainAdminAccess bool) *TeamdrivesListCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then all Team Drives of the domain in which the requester is an administrator are returned.

type TeamdrivesService

type TeamdrivesService struct {
	// contains filtered or unexported fields
}

func NewTeamdrivesService

func NewTeamdrivesService(s *Service) *TeamdrivesService

func (*TeamdrivesService) Create

func (r *TeamdrivesService) Create(requestId string, teamdrive *TeamDrive) *TeamdrivesCreateCall

Create: Deprecated: Use `drives.create` instead.

  • requestId: An ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a Team Drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same Team Drive. If the Team Drive already exists a 409 error will be returned.

func (*TeamdrivesService) Delete

func (r *TeamdrivesService) Delete(teamDriveId string) *TeamdrivesDeleteCall

Delete: Deprecated: Use `drives.delete` instead.

- teamDriveId: The ID of the Team Drive.

func (*TeamdrivesService) Get

func (r *TeamdrivesService) Get(teamDriveId string) *TeamdrivesGetCall

Get: Deprecated: Use `drives.get` instead.

- teamDriveId: The ID of the Team Drive.

func (*TeamdrivesService) List

List: Deprecated: Use `drives.list` instead.

func (*TeamdrivesService) Update

func (r *TeamdrivesService) Update(teamDriveId string, teamdrive *TeamDrive) *TeamdrivesUpdateCall

Update: Deprecated: Use `drives.update` instead.

- teamDriveId: The ID of the Team Drive.

type TeamdrivesUpdateCall

type TeamdrivesUpdateCall struct {
	// contains filtered or unexported fields
}

func (*TeamdrivesUpdateCall) Context

Context sets the context to be used in this call's Do method.

func (*TeamdrivesUpdateCall) Do

Do executes the "drive.teamdrives.update" call. Any non-2xx status code is an error. Response headers are in either *TeamDrive.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 (*TeamdrivesUpdateCall) Fields

Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more details.

func (*TeamdrivesUpdateCall) Header

func (c *TeamdrivesUpdateCall) Header() http.Header

Header returns a http.Header that can be modified by the caller to add headers to the request.

func (*TeamdrivesUpdateCall) UseDomainAdminAccess

func (c *TeamdrivesUpdateCall) UseDomainAdminAccess(useDomainAdminAccess bool) *TeamdrivesUpdateCall

UseDomainAdminAccess sets the optional parameter "useDomainAdminAccess": Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the Team Drive belongs.

type User

type User struct {
	// DisplayName: Output only. A plain text displayable name for this user.
	DisplayName string `json:"displayName,omitempty"`
	// EmailAddress: Output only. The email address of the user. This may not be
	// present in certain contexts if the user has not made their email address
	// visible to the requester.
	EmailAddress string `json:"emailAddress,omitempty"`
	// Kind: Output only. Identifies what kind of resource this is. Value: the
	// fixed string "drive#user".
	Kind string `json:"kind,omitempty"`
	// Me: Output only. Whether this user is the requesting user.
	Me bool `json:"me,omitempty"`
	// PermissionId: Output only. The user's ID as visible in Permission resources.
	PermissionId string `json:"permissionId,omitempty"`
	// PhotoLink: Output only. A link to the user's profile photo, if available.
	PhotoLink string `json:"photoLink,omitempty"`
	// ForceSendFields is a list of field names (e.g. "DisplayName") to
	// unconditionally include in API requests. By default, fields with empty or
	// default values are omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more
	// details.
	ForceSendFields []string `json:"-"`
	// NullFields is a list of field names (e.g. "DisplayName") to include in API
	// requests with the JSON null value. By default, fields with empty values are
	// omitted from API requests. See
	// https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details.
	NullFields []string `json:"-"`
}

User: Information about a Drive user.

func (User) MarshalJSON

func (s User) MarshalJSON() ([]byte, error)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL