mybusinessaccountmanagement

package
v0.214.0 Latest Latest
Warning

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

Go to latest
Published: Dec 19, 2024 License: BSD-3-Clause Imports: 18 Imported by: 0

Documentation

Overview

Package mybusinessaccountmanagement provides access to the My Business Account Management API.

For product documentation, see: https://developers.google.com/my-business/

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/mybusinessaccountmanagement/v1"
...
ctx := context.Background()
mybusinessaccountmanagementService, err := mybusinessaccountmanagement.NewService(ctx)

In this example, Google Application Default Credentials are used for authentication. For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.

Other authentication options

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

mybusinessaccountmanagementService, err := mybusinessaccountmanagement.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, ...)
mybusinessaccountmanagementService, err := mybusinessaccountmanagement.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))

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

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AcceptInvitationRequest

type AcceptInvitationRequest struct {
}

AcceptInvitationRequest: Request message for AccessControl.AcceptInvitation.

type Account

type Account struct {
	// AccountName: Required. The name of the account. For an account of type
	// `PERSONAL`, this is the first and last name of the user account.
	AccountName string `json:"accountName,omitempty"`
	// AccountNumber: Output only. Account reference number if provisioned.
	AccountNumber string `json:"accountNumber,omitempty"`
	// Name: Immutable. The resource name, in the format `accounts/{account_id}`.
	Name string `json:"name,omitempty"`
	// OrganizationInfo: Output only. Additional info for an organization. This is
	// populated only for an organization account.
	OrganizationInfo *OrganizationInfo `json:"organizationInfo,omitempty"`
	// PermissionLevel: Output only. Specifies the permission level the user has
	// for this account.
	//
	// Possible values:
	//   "PERMISSION_LEVEL_UNSPECIFIED" - Not specified.
	//   "OWNER_LEVEL" - The user has owner level permission.
	//   "MEMBER_LEVEL" - The user has member level permission.
	PermissionLevel string `json:"permissionLevel,omitempty"`
	// PrimaryOwner: Required. Input only. The resource name of the account which
	// will be the primary owner of the account being created. It should be of the
	// form `accounts/{account_id}`.
	PrimaryOwner string `json:"primaryOwner,omitempty"`
	// Role: Output only. Specifies the AccountRole of this account.
	//
	// Possible values:
	//   "ACCOUNT_ROLE_UNSPECIFIED" - Not specified.
	//   "PRIMARY_OWNER" - The user is the primary owner this account.
	//   "OWNER" - The user owner of the account.
	//   "MANAGER" - The user can manage this account.
	//   "SITE_MANAGER" - The user can manage a limited set of features for the
	// account.
	Role string `json:"role,omitempty"`
	// Type: Required. Contains the type of account. Accounts of type PERSONAL and
	// ORGANIZATION cannot be created using this API.
	//
	// Possible values:
	//   "ACCOUNT_TYPE_UNSPECIFIED" - Not specified.
	//   "PERSONAL" - An end-user account.
	//   "LOCATION_GROUP" - A group of Locations. For more information, see the
	// [help center article] (https://support.google.com/business/answer/6085326)
	//   "USER_GROUP" - A User Group for segregating organization staff in groups.
	// For more information, see the [help center
	// article](https://support.google.com/business/answer/7655731)
	//   "ORGANIZATION" - An organization representing a company. For more
	// information, see the [help center
	// article](https://support.google.com/business/answer/7663063)
	Type string `json:"type,omitempty"`
	// VerificationState: Output only. If verified, future locations that are
	// created are automatically connected to Google Maps, and have Google+ pages
	// created, without requiring moderation.
	//
	// Possible values:
	//   "VERIFICATION_STATE_UNSPECIFIED" - Not specified.
	//   "VERIFIED" - Verified account.
	//   "UNVERIFIED" - Account that is not verified, and verification has not been
	// requested.
	//   "VERIFICATION_REQUESTED" - Account that is not verified, but verification
	// has been requested.
	VerificationState string `json:"verificationState,omitempty"`
	// VettedState: Output only. Indicates whether the account is vetted by Google.
	// A vetted account is able to verify locations via the VETTED_PARTNER method.
	//
	// Possible values:
	//   "VETTED_STATE_UNSPECIFIED" - Not Specified
	//   "NOT_VETTED" - The account is not vetted by Google.
	//   "VETTED" - The account is vetted by Google and in a valid state. An
	// account is automatically vetted if it has direct access to a vetted group
	// account.
	//   "INVALID" - The account is vetted but in an invalid state. The account
	// will behave like an unvetted account.
	VettedState string `json:"vettedState,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AccountName") 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. "AccountName") 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:"-"`
}

Account: An account is a container for your location. If you are the only user who manages locations for your business, you can use your personal Google Account. To share management of locations with multiple users, [create a business account] (https://support.google.com/business/answer/6085339?ref_topic=6085325).

func (Account) MarshalJSON

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

type AccountsAdminsCreateCall

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

func (*AccountsAdminsCreateCall) Context

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

func (*AccountsAdminsCreateCall) Do

Do executes the "mybusinessaccountmanagement.accounts.admins.create" call. Any non-2xx status code is an error. Response headers are in either *Admin.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 (*AccountsAdminsCreateCall) Fields

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

func (*AccountsAdminsCreateCall) Header

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

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

type AccountsAdminsDeleteCall

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

func (*AccountsAdminsDeleteCall) Context

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

func (*AccountsAdminsDeleteCall) Do

Do executes the "mybusinessaccountmanagement.accounts.admins.delete" call. Any non-2xx status code is an error. Response headers are in either *Empty.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 (*AccountsAdminsDeleteCall) Fields

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

func (*AccountsAdminsDeleteCall) Header

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

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

type AccountsAdminsListCall

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

func (*AccountsAdminsListCall) Context

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

func (*AccountsAdminsListCall) Do

Do executes the "mybusinessaccountmanagement.accounts.admins.list" call. Any non-2xx status code is an error. Response headers are in either *ListAccountAdminsResponse.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 (*AccountsAdminsListCall) Fields

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

func (*AccountsAdminsListCall) Header

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

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

func (*AccountsAdminsListCall) IfNoneMatch

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

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 AccountsAdminsPatchCall

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

func (*AccountsAdminsPatchCall) Context

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

func (*AccountsAdminsPatchCall) Do

Do executes the "mybusinessaccountmanagement.accounts.admins.patch" call. Any non-2xx status code is an error. Response headers are in either *Admin.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 (*AccountsAdminsPatchCall) Fields

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

func (*AccountsAdminsPatchCall) Header

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

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

func (*AccountsAdminsPatchCall) UpdateMask

func (c *AccountsAdminsPatchCall) UpdateMask(updateMask string) *AccountsAdminsPatchCall

UpdateMask sets the optional parameter "updateMask": Required. The specific fields that should be updated. The only editable field is role.

type AccountsAdminsService

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

func NewAccountsAdminsService

func NewAccountsAdminsService(s *Service) *AccountsAdminsService

func (*AccountsAdminsService) Create

func (r *AccountsAdminsService) Create(parent string, admin *Admin) *AccountsAdminsCreateCall

Create: Invites the specified user to become an administrator for the specified account. The invitee must accept the invitation in order to be granted access to the account. See AcceptInvitation to programmatically accept an invitation.

  • parent: The resource name of the account this admin is created for. `accounts/{account_id}`.

func (*AccountsAdminsService) Delete

Delete: Removes the specified admin from the specified account.

  • name: The resource name of the admin to remove from the account. `accounts/{account_id}/admins/{admin_id}`.

func (*AccountsAdminsService) List

List: Lists the admins for the specified account.

  • parent: The name of the account from which to retrieve a list of admins. `accounts/{account_id}/admins`.

func (*AccountsAdminsService) Patch

Patch: Updates the Admin for the specified Account Admin.

  • name: Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{location_id}/admins/{admin_id}` This field will be ignored if set during admin creation.

type AccountsCreateCall

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

func (*AccountsCreateCall) Context

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

func (*AccountsCreateCall) Do

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

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

func (*AccountsCreateCall) Header

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

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

type AccountsGetCall

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

func (*AccountsGetCall) Context

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

func (*AccountsGetCall) Do

func (c *AccountsGetCall) Do(opts ...googleapi.CallOption) (*Account, error)

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

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

func (*AccountsGetCall) Header

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

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

func (*AccountsGetCall) IfNoneMatch

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

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 AccountsInvitationsAcceptCall

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

func (*AccountsInvitationsAcceptCall) Context

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

func (*AccountsInvitationsAcceptCall) Do

Do executes the "mybusinessaccountmanagement.accounts.invitations.accept" call. Any non-2xx status code is an error. Response headers are in either *Empty.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 (*AccountsInvitationsAcceptCall) Fields

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

func (*AccountsInvitationsAcceptCall) Header

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

type AccountsInvitationsDeclineCall

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

func (*AccountsInvitationsDeclineCall) Context

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

func (*AccountsInvitationsDeclineCall) Do

Do executes the "mybusinessaccountmanagement.accounts.invitations.decline" call. Any non-2xx status code is an error. Response headers are in either *Empty.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 (*AccountsInvitationsDeclineCall) Fields

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

func (*AccountsInvitationsDeclineCall) Header

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

type AccountsInvitationsListCall

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

func (*AccountsInvitationsListCall) Context

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

func (*AccountsInvitationsListCall) Do

Do executes the "mybusinessaccountmanagement.accounts.invitations.list" call. Any non-2xx status code is an error. Response headers are in either *ListInvitationsResponse.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 (*AccountsInvitationsListCall) Fields

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

func (*AccountsInvitationsListCall) Filter

Filter sets the optional parameter "filter": Filtering the response is supported via the Invitation.target_type field.

func (*AccountsInvitationsListCall) Header

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

func (*AccountsInvitationsListCall) 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.

type AccountsInvitationsService

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

func NewAccountsInvitationsService

func NewAccountsInvitationsService(s *Service) *AccountsInvitationsService

func (*AccountsInvitationsService) Accept

Accept: Accepts the specified invitation.

  • name: The name of the invitation that is being accepted. `accounts/{account_id}/invitations/{invitation_id}`.

func (*AccountsInvitationsService) Decline

Decline: Declines the specified invitation.

  • name: The name of the account invitation that is being declined. `accounts/{account_id}/invitations/{invitation_id}`.

func (*AccountsInvitationsService) List

List: Lists pending invitations for the specified account.

  • parent: The name of the account from which the list of invitations is being retrieved. `accounts/{account_id}/invitations`.

type AccountsListCall

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

func (*AccountsListCall) Context

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

func (*AccountsListCall) Do

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

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

func (*AccountsListCall) Filter

func (c *AccountsListCall) Filter(filter string) *AccountsListCall

Filter sets the optional parameter "filter": A filter constraining the accounts to return. The response includes only entries that match the filter. If `filter` is empty, then no constraints are applied and all accounts (paginated) are retrieved for the requested account. For example, a request with the filter `type=USER_GROUP` will only return user groups. The `type` field is the only supported filter.

func (*AccountsListCall) Header

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

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

func (*AccountsListCall) IfNoneMatch

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

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 (*AccountsListCall) PageSize

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

PageSize sets the optional parameter "pageSize": How many accounts to fetch per page. The default and maximum is 20.

func (*AccountsListCall) PageToken

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

PageToken sets the optional parameter "pageToken": If specified, the next page of accounts is retrieved. The `pageToken` is returned when a call to `accounts.list` returns more results than can fit into the requested page size.

func (*AccountsListCall) Pages

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 (*AccountsListCall) ParentAccount

func (c *AccountsListCall) ParentAccount(parentAccount string) *AccountsListCall

ParentAccount sets the optional parameter "parentAccount": The resource name of the account for which the list of directly accessible accounts is to be retrieved. This only makes sense for Organizations and User Groups. If empty, will return `ListAccounts` for the authenticated user. `accounts/{account_id}`.

type AccountsPatchCall

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

func (*AccountsPatchCall) Context

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

func (*AccountsPatchCall) Do

func (c *AccountsPatchCall) Do(opts ...googleapi.CallOption) (*Account, error)

Do executes the "mybusinessaccountmanagement.accounts.patch" call. Any non-2xx status code is an error. Response headers are in either *Account.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 (*AccountsPatchCall) Fields

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

func (*AccountsPatchCall) Header

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

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

func (*AccountsPatchCall) UpdateMask

func (c *AccountsPatchCall) UpdateMask(updateMask string) *AccountsPatchCall

UpdateMask sets the optional parameter "updateMask": Required. The specific fields that should be updated. The only editable field is `accountName`.

func (*AccountsPatchCall) ValidateOnly

func (c *AccountsPatchCall) ValidateOnly(validateOnly bool) *AccountsPatchCall

ValidateOnly sets the optional parameter "validateOnly": If true, the request is validated without actually updating the account.

type AccountsService

type AccountsService struct {
	Admins *AccountsAdminsService

	Invitations *AccountsInvitationsService
	// contains filtered or unexported fields
}

func NewAccountsService

func NewAccountsService(s *Service) *AccountsService

func (*AccountsService) Create

func (r *AccountsService) Create(account *Account) *AccountsCreateCall

Create: Creates an account with the specified name and type under the given parent. - Personal accounts and Organizations cannot be created. - User Groups cannot be created with a Personal account as primary owner. - Location Groups cannot be created with a primary owner of a Personal account if the Personal account is in an Organization. - Location Groups cannot own Location Groups.

func (*AccountsService) Get

func (r *AccountsService) Get(name string) *AccountsGetCall

Get: Gets the specified account. Returns `NOT_FOUND` if the account does not exist or if the caller does not have access rights to it.

- name: The name of the account to fetch.

func (*AccountsService) List

func (r *AccountsService) List() *AccountsListCall

List: Lists all of the accounts for the authenticated user. This includes all accounts that the user owns, as well as any accounts for which the user has management rights.

func (*AccountsService) Patch

func (r *AccountsService) Patch(name string, account *Account) *AccountsPatchCall

Patch: Updates the specified business account. Personal accounts cannot be updated using this method.

- name: Immutable. The resource name, in the format `accounts/{account_id}`.

type Admin

type Admin struct {
	// Account: Immutable. The name of the Account resource that this Admin refers
	// to. Used when calling locations.admins.create to invite a LocationGroup as
	// an admin. If both this field and `admin` are set on `CREATE` requests, this
	// field takes precedence and the email address in `admin` will be ignored.
	// Format: `accounts/{account}`.
	Account string `json:"account,omitempty"`
	// Admin: Optional. The name of the admin. When making the initial invitation,
	// this is the invitee's email address. On `GET` calls, the user's email
	// address is returned if the invitation is still pending. Otherwise, it
	// contains the user's first and last names. This field is only needed to be
	// set during admin creation.
	Admin string `json:"admin,omitempty"`
	// Name: Immutable. The resource name. For account admins, this is in the form:
	// `accounts/{account_id}/admins/{admin_id}` For location admins, this is in
	// the form: `locations/{location_id}/admins/{admin_id}` This field will be
	// ignored if set during admin creation.
	Name string `json:"name,omitempty"`
	// PendingInvitation: Output only. Indicates whether this admin has a pending
	// invitation for the specified resource.
	PendingInvitation bool `json:"pendingInvitation,omitempty"`
	// Role: Required. Specifies the role that this admin uses with the specified
	// Account or Location.
	//
	// Possible values:
	//   "ADMIN_ROLE_UNSPECIFIED" - Not specified.
	//   "PRIMARY_OWNER" - The admin has owner-level access and is the primary
	// owner. (Displays as 'Primary Owner' in UI).
	//   "OWNER" - The admin has owner-level access. (Displays as 'Owner' in UI).
	//   "MANAGER" - The admin has managerial access.
	//   "SITE_MANAGER" - The admin can manage social (Google+) pages. (Displays as
	// 'Site Manager' in UI). This API doesn't allow creating an account admin with
	// a SITE_MANAGER role.
	Role string `json:"role,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Account") 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. "Account") 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:"-"`
}

Admin: An administrator of an Account or a location.

func (Admin) MarshalJSON

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

type DeclineInvitationRequest

type DeclineInvitationRequest struct {
}

DeclineInvitationRequest: Request message for AccessControl.DeclineInvitation.

type Empty

type Empty struct {
	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
}

Empty: A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

type Invitation

type Invitation struct {
	// Name: Required. The resource name for the invitation.
	// `accounts/{account_id}/invitations/{invitation_id}`.
	Name string `json:"name,omitempty"`
	// Role: Output only. The invited role on the account.
	//
	// Possible values:
	//   "ADMIN_ROLE_UNSPECIFIED" - Not specified.
	//   "PRIMARY_OWNER" - The admin has owner-level access and is the primary
	// owner. (Displays as 'Primary Owner' in UI).
	//   "OWNER" - The admin has owner-level access. (Displays as 'Owner' in UI).
	//   "MANAGER" - The admin has managerial access.
	//   "SITE_MANAGER" - The admin can manage social (Google+) pages. (Displays as
	// 'Site Manager' in UI). This API doesn't allow creating an account admin with
	// a SITE_MANAGER role.
	Role string `json:"role,omitempty"`
	// TargetAccount: The sparsely populated account this invitation is for.
	TargetAccount *Account `json:"targetAccount,omitempty"`
	// TargetLocation: The target location this invitation is for.
	TargetLocation *TargetLocation `json:"targetLocation,omitempty"`
	// TargetType: Output only. Specifies which target types should appear in the
	// response.
	//
	// Possible values:
	//   "TARGET_TYPE_UNSPECIFIED" - Set when target type is unspecified.
	//   "ACCOUNTS_ONLY" - List invitations only for targets of type Account.
	//   "LOCATIONS_ONLY" - List invitations only for targets of type Location.
	TargetType string `json:"targetType,omitempty"`
	// ForceSendFields is a list of field names (e.g. "Name") 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. "Name") 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:"-"`
}

Invitation: Represents a pending invitation.

func (Invitation) MarshalJSON

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

type ListAccountAdminsResponse

type ListAccountAdminsResponse struct {
	// AccountAdmins: A collection of Admin instances.
	AccountAdmins []*Admin `json:"accountAdmins,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "AccountAdmins") 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. "AccountAdmins") 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:"-"`
}

ListAccountAdminsResponse: Response message for AccessControl.ListAccountAdmins.

func (ListAccountAdminsResponse) MarshalJSON

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

type ListAccountsResponse

type ListAccountsResponse struct {
	// Accounts: A collection of accounts to which the user has access. The
	// personal account of the user doing the query will always be the first item
	// of the result, unless it is filtered out.
	Accounts []*Account `json:"accounts,omitempty"`
	// NextPageToken: If the number of accounts exceeds the requested page size,
	// this field is populated with a token to fetch the next page of accounts on a
	// subsequent call to `accounts.list`. If there are no more accounts, this
	// field is not present in the response.
	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. "Accounts") 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. "Accounts") 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:"-"`
}

ListAccountsResponse: Response message for Accounts.ListAccounts.

func (ListAccountsResponse) MarshalJSON

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

type ListInvitationsResponse

type ListInvitationsResponse struct {
	// Invitations: A collection of invitations that are pending for the account.
	// The number of invitations listed here cannot exceed 1000.
	Invitations []*Invitation `json:"invitations,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Invitations") 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. "Invitations") 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:"-"`
}

ListInvitationsResponse: Response message for AccessControl.ListInvitations.

func (ListInvitationsResponse) MarshalJSON

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

type ListLocationAdminsResponse

type ListLocationAdminsResponse struct {
	// Admins: A collection of Admins.
	Admins []*Admin `json:"admins,omitempty"`

	// ServerResponse contains the HTTP response code and headers from the server.
	googleapi.ServerResponse `json:"-"`
	// ForceSendFields is a list of field names (e.g. "Admins") 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. "Admins") 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:"-"`
}

ListLocationAdminsResponse: Response message for AccessControl.ListLocationAdmins.

func (ListLocationAdminsResponse) MarshalJSON

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

type LocationsAdminsCreateCall

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

func (*LocationsAdminsCreateCall) Context

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

func (*LocationsAdminsCreateCall) Do

Do executes the "mybusinessaccountmanagement.locations.admins.create" call. Any non-2xx status code is an error. Response headers are in either *Admin.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 (*LocationsAdminsCreateCall) Fields

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

func (*LocationsAdminsCreateCall) Header

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

type LocationsAdminsDeleteCall

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

func (*LocationsAdminsDeleteCall) Context

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

func (*LocationsAdminsDeleteCall) Do

Do executes the "mybusinessaccountmanagement.locations.admins.delete" call. Any non-2xx status code is an error. Response headers are in either *Empty.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 (*LocationsAdminsDeleteCall) Fields

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

func (*LocationsAdminsDeleteCall) Header

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

type LocationsAdminsListCall

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

func (*LocationsAdminsListCall) Context

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

func (*LocationsAdminsListCall) Do

Do executes the "mybusinessaccountmanagement.locations.admins.list" call. Any non-2xx status code is an error. Response headers are in either *ListLocationAdminsResponse.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 (*LocationsAdminsListCall) Fields

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

func (*LocationsAdminsListCall) Header

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

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

func (*LocationsAdminsListCall) IfNoneMatch

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

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 LocationsAdminsPatchCall

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

func (*LocationsAdminsPatchCall) Context

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

func (*LocationsAdminsPatchCall) Do

Do executes the "mybusinessaccountmanagement.locations.admins.patch" call. Any non-2xx status code is an error. Response headers are in either *Admin.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 (*LocationsAdminsPatchCall) Fields

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

func (*LocationsAdminsPatchCall) Header

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

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

func (*LocationsAdminsPatchCall) UpdateMask

func (c *LocationsAdminsPatchCall) UpdateMask(updateMask string) *LocationsAdminsPatchCall

UpdateMask sets the optional parameter "updateMask": Required. The specific fields that should be updated. The only editable field is role.

type LocationsAdminsService

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

func NewLocationsAdminsService

func NewLocationsAdminsService(s *Service) *LocationsAdminsService

func (*LocationsAdminsService) Create

func (r *LocationsAdminsService) Create(parent string, admin *Admin) *LocationsAdminsCreateCall

Create: Invites the specified user to become an administrator for the specified location. The invitee must accept the invitation in order to be granted access to the location. See AcceptInvitation to programmatically accept an invitation.

  • parent: The resource name of the location this admin is created for. `locations/{location_id}/admins`.

func (*LocationsAdminsService) Delete

Delete: Removes the specified admin as a manager of the specified location.

- name: The resource name of the admin to remove from the location.

func (*LocationsAdminsService) List

List: Lists all of the admins for the specified location.

  • parent: The name of the location to list admins of. `locations/{location_id}/admins`.

func (*LocationsAdminsService) Patch

Patch: Updates the Admin for the specified location. Only the AdminRole of the Admin can be updated.

  • name: Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{location_id}/admins/{admin_id}` This field will be ignored if set during admin creation.

type LocationsService

type LocationsService struct {
	Admins *LocationsAdminsService
	// contains filtered or unexported fields
}

func NewLocationsService

func NewLocationsService(s *Service) *LocationsService

func (*LocationsService) Transfer added in v0.47.0

func (r *LocationsService) Transfer(name string, transferlocationrequest *TransferLocationRequest) *LocationsTransferCall

Transfer: Moves a location from an account that the user owns to another account that the same user administers. The user must be an owner of the account the location is currently associated with and must also be at least a manager of the destination account.

- name: The name of the location to transfer. `locations/{location_id}`.

type LocationsTransferCall added in v0.47.0

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

func (*LocationsTransferCall) Context added in v0.47.0

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

func (*LocationsTransferCall) Do added in v0.47.0

Do executes the "mybusinessaccountmanagement.locations.transfer" call. Any non-2xx status code is an error. Response headers are in either *Empty.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 (*LocationsTransferCall) Fields added in v0.47.0

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

func (*LocationsTransferCall) Header added in v0.47.0

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

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

type OrganizationInfo

type OrganizationInfo struct {
	// Address: Output only. The postal address for the account.
	Address *PostalAddress `json:"address,omitempty"`
	// PhoneNumber: Output only. The contact number for the organization.
	PhoneNumber string `json:"phoneNumber,omitempty"`
	// RegisteredDomain: Output only. The registered domain for the account.
	RegisteredDomain string `json:"registeredDomain,omitempty"`
	// 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:"-"`
}

OrganizationInfo: Additional information stored for an organization.

func (OrganizationInfo) MarshalJSON

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

type PostalAddress

type PostalAddress struct {
	// AddressLines: Unstructured address lines describing the lower levels of an
	// address. Because values in address_lines do not have type information and
	// may sometimes contain multiple values in a single field (For example
	// "Austin, TX"), it is important that the line order is clear. The order of
	// address lines should be "envelope order" for the country/region of the
	// address. In places where this can vary (For example Japan), address_language
	// is used to make it explicit (For example "ja" for large-to-small ordering
	// and "ja-Latn" or "en" for small-to-large). This way, the most specific line
	// of an address can be selected based on the language. The minimum permitted
	// structural representation of an address consists of a region_code with all
	// remaining information placed in the address_lines. It would be possible to
	// format such an address very approximately without geocoding, but no semantic
	// reasoning could be made about any of the address components until it was at
	// least partially resolved. Creating an address only containing a region_code
	// and address_lines, and then geocoding is the recommended way to handle
	// completely unstructured addresses (as opposed to guessing which parts of the
	// address should be localities or administrative areas).
	AddressLines []string `json:"addressLines,omitempty"`
	// AdministrativeArea: Optional. Highest administrative subdivision which is
	// used for postal addresses of a country or region. For example, this can be a
	// state, a province, an oblast, or a prefecture. Specifically, for Spain this
	// is the province and not the autonomous community (For example "Barcelona"
	// and not "Catalonia"). Many countries don't use an administrative area in
	// postal addresses. For example in Switzerland this should be left
	// unpopulated.
	AdministrativeArea string `json:"administrativeArea,omitempty"`
	// LanguageCode: Optional. BCP-47 language code of the contents of this address
	// (if known). This is often the UI language of the input form or is expected
	// to match one of the languages used in the address' country/region, or their
	// transliterated equivalents. This can affect formatting in certain countries,
	// but is not critical to the correctness of the data and will never affect any
	// validation or other non-formatting related operations. If this value is not
	// known, it should be omitted (rather than specifying a possibly incorrect
	// default). Examples: "zh-Hant", "ja", "ja-Latn", "en".
	LanguageCode string `json:"languageCode,omitempty"`
	// Locality: Optional. Generally refers to the city/town portion of the
	// address. Examples: US city, IT comune, UK post town. In regions of the world
	// where localities are not well defined or do not fit into this structure
	// well, leave locality empty and use address_lines.
	Locality string `json:"locality,omitempty"`
	// Organization: Optional. The name of the organization at the address.
	Organization string `json:"organization,omitempty"`
	// PostalCode: Optional. Postal code of the address. Not all countries use or
	// require postal codes to be present, but where they are used, they may
	// trigger additional validation with other parts of the address (For example
	// state/zip validation in the U.S.A.).
	PostalCode string `json:"postalCode,omitempty"`
	// Recipients: Optional. The recipient at the address. This field may, under
	// certain circumstances, contain multiline information. For example, it might
	// contain "care of" information.
	Recipients []string `json:"recipients,omitempty"`
	// RegionCode: Required. CLDR region code of the country/region of the address.
	// This is never inferred and it is up to the user to ensure the value is
	// correct. See https://cldr.unicode.org/ and
	// https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html
	// for details. Example: "CH" for Switzerland.
	RegionCode string `json:"regionCode,omitempty"`
	// Revision: The schema revision of the `PostalAddress`. This must be set to 0,
	// which is the latest revision. All new revisions **must** be backward
	// compatible with old revisions.
	Revision int64 `json:"revision,omitempty"`
	// SortingCode: Optional. Additional, country-specific, sorting code. This is
	// not used in most regions. Where it is used, the value is either a string
	// like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or
	// just a number alone, representing the "sector code" (Jamaica), "delivery
	// area indicator" (Malawi) or "post office indicator" (For example Côte
	// d'Ivoire).
	SortingCode string `json:"sortingCode,omitempty"`
	// Sublocality: Optional. Sublocality of the address. For example, this can be
	// neighborhoods, boroughs, districts.
	Sublocality string `json:"sublocality,omitempty"`
	// ForceSendFields is a list of field names (e.g. "AddressLines") 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. "AddressLines") 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:"-"`
}

PostalAddress: Represents a postal address. For example for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478

func (PostalAddress) MarshalJSON

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

type Service

type Service struct {
	BasePath  string // API endpoint base URL
	UserAgent string // optional additional User-Agent fragment

	Accounts *AccountsService

	Locations *LocationsService
	// 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

func NewService(ctx context.Context, opts ...option.ClientOption) (*Service, error)

NewService creates a new Service.

type TargetLocation

type TargetLocation struct {
	// Address: The address of the location to which the user is invited.
	Address string `json:"address,omitempty"`
	// LocationName: The name of the location to which the user is invited.
	LocationName string `json:"locationName,omitempty"`
	// 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:"-"`
}

TargetLocation: Represents a target location for a pending invitation.

func (TargetLocation) MarshalJSON

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

type TransferLocationRequest added in v0.44.0

type TransferLocationRequest struct {
	// DestinationAccount: Required. Name of the account resource to transfer the
	// location to (for example, "accounts/{account}").
	DestinationAccount string `json:"destinationAccount,omitempty"`
	// ForceSendFields is a list of field names (e.g. "DestinationAccount") 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. "DestinationAccount") 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:"-"`
}

TransferLocationRequest: Request message for AccessControl.TransferLocation.

func (TransferLocationRequest) MarshalJSON added in v0.44.0

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

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL