google-ads-nodejs-client
Version:
Googleads client for Node.js
980 lines • 262 kB
TypeScript
import type * as gax from 'google-gax';
import type { Callback, CallOptions, Descriptors, ClientOptions, LROperation, PaginationCallback } from 'google-gax';
import { Transform } from 'stream';
import * as protos from '../../protos/protos';
/**
* Service to manage experiments.
* @class
* @memberof v21
*/
export declare class ExperimentServiceClient {
private _terminated;
private _opts;
private _providedCustomServicePath;
private _gaxModule;
private _gaxGrpc;
private _protos;
private _defaults;
private _universeDomain;
private _servicePath;
private _log;
auth: gax.GoogleAuth;
descriptors: Descriptors;
warn: (code: string, message: string, warnType?: string) => void;
innerApiCalls: {
[name: string]: Function;
};
pathTemplates: {
[name: string]: gax.PathTemplate;
};
operationsClient: gax.OperationsClient;
experimentServiceStub?: Promise<{
[name: string]: Function;
}>;
/**
* Construct an instance of ExperimentServiceClient.
*
* @param {object} [options] - The configuration object.
* The options accepted by the constructor are described in detail
* in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
* The common options are:
* @param {object} [options.credentials] - Credentials object.
* @param {string} [options.credentials.client_email]
* @param {string} [options.credentials.private_key]
* @param {string} [options.email] - Account email address. Required when
* using a .pem or .p12 keyFilename.
* @param {string} [options.keyFilename] - Full path to the a .json, .pem, or
* .p12 key downloaded from the Google Developers Console. If you provide
* a path to a JSON file, the projectId option below is not necessary.
* NOTE: .pem and .p12 require you to specify options.email as well.
* @param {number} [options.port] - The port on which to connect to
* the remote host.
* @param {string} [options.projectId] - The project ID from the Google
* Developer's Console, e.g. 'grape-spaceship-123'. We will also check
* the environment variable GCLOUD_PROJECT for your project ID. If your
* app is running in an environment which supports
* {@link https://cloud.google.com/docs/authentication/application-default-credentials Application Default Credentials},
* your project ID will be detected automatically.
* @param {string} [options.apiEndpoint] - The domain name of the
* API remote host.
* @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
* Follows the structure of {@link gapicConfig}.
* @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
* For more information, please check the
* {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
* @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
* need to avoid loading the default gRPC version and want to use the fallback
* HTTP implementation. Load only fallback version and pass it to the constructor:
* ```
* const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
* const client = new ExperimentServiceClient({fallback: true}, gax);
* ```
*/
constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
/**
* Initialize the client.
* Performs asynchronous operations (such as authentication) and prepares the client.
* This function will be called automatically when any class method is called for the
* first time, but if you need to initialize it before calling an actual method,
* feel free to call initialize() directly.
*
* You can await on this method if you want to make sure the client is initialized.
*
* @returns {Promise} A promise that resolves to an authenticated service stub.
*/
initialize(): Promise<{
[name: string]: Function;
}>;
/**
* The DNS address for this API service.
* @deprecated Use the apiEndpoint method of the client instance.
* @returns {string} The DNS address for this service.
*/
static get servicePath(): string;
/**
* The DNS address for this API service - same as servicePath.
* @deprecated Use the apiEndpoint method of the client instance.
* @returns {string} The DNS address for this service.
*/
static get apiEndpoint(): string;
/**
* The DNS address for this API service.
* @returns {string} The DNS address for this service.
*/
get apiEndpoint(): string;
get universeDomain(): string;
/**
* The port for this API service.
* @returns {number} The default port for this service.
*/
static get port(): number;
/**
* The scopes needed to make gRPC calls for every method defined
* in this service.
* @returns {string[]} List of default scopes.
*/
static get scopes(): string[];
getProjectId(): Promise<string>;
getProjectId(callback: Callback<string, undefined, undefined>): void;
/**
* Creates, updates, or removes experiments. Operation statuses are returned.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [QuotaError]()
* [RequestError]()
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.customerId
* Required. The ID of the customer whose experiments are being modified.
* @param {number[]} request.operations
* Required. The list of operations to perform on individual experiments.
* @param {boolean} request.partialFailure
* If true, successful operations will be carried out and invalid
* operations will return errors. If false, all operations will be carried
* out in one transaction if and only if they are all valid.
* Default is false.
* @param {boolean} request.validateOnly
* If true, the request is validated but not executed. Only errors are
* returned, not results.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.ads.googleads.v21.services.MutateExperimentsResponse|MutateExperimentsResponse}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.mutate_experiments.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_MutateExperiments_async
*/
mutateExperiments(request?: protos.google.ads.googleads.v21.services.IMutateExperimentsRequest, options?: CallOptions): Promise<[
protos.google.ads.googleads.v21.services.IMutateExperimentsResponse,
protos.google.ads.googleads.v21.services.IMutateExperimentsRequest | undefined,
{} | undefined
]>;
mutateExperiments(request: protos.google.ads.googleads.v21.services.IMutateExperimentsRequest, options: CallOptions, callback: Callback<protos.google.ads.googleads.v21.services.IMutateExperimentsResponse, protos.google.ads.googleads.v21.services.IMutateExperimentsRequest | null | undefined, {} | null | undefined>): void;
mutateExperiments(request: protos.google.ads.googleads.v21.services.IMutateExperimentsRequest, callback: Callback<protos.google.ads.googleads.v21.services.IMutateExperimentsResponse, protos.google.ads.googleads.v21.services.IMutateExperimentsRequest | null | undefined, {} | null | undefined>): void;
/**
* Immediately ends an experiment, changing the experiment's scheduled
* end date and without waiting for end of day. End date is updated to be the
* time of the request.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [QuotaError]()
* [RequestError]()
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.experiment
* Required. The resource name of the campaign experiment to end.
* @param {boolean} request.validateOnly
* If true, the request is validated but not executed. Only errors are
* returned, not results.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.end_experiment.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_EndExperiment_async
*/
endExperiment(request?: protos.google.ads.googleads.v21.services.IEndExperimentRequest, options?: CallOptions): Promise<[
protos.google.protobuf.IEmpty,
protos.google.ads.googleads.v21.services.IEndExperimentRequest | undefined,
{} | undefined
]>;
endExperiment(request: protos.google.ads.googleads.v21.services.IEndExperimentRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IEndExperimentRequest | null | undefined, {} | null | undefined>): void;
endExperiment(request: protos.google.ads.googleads.v21.services.IEndExperimentRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IEndExperimentRequest | null | undefined, {} | null | undefined>): void;
/**
* Graduates an experiment to a full campaign.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [MutateError]()
* [QuotaError]()
* [RequestError]()
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.experiment
* Required. The experiment to be graduated.
* @param {number[]} request.campaignBudgetMappings
* Required. List of campaign budget mappings for graduation. Each campaign
* that appears here will graduate, and will be assigned a new budget that is
* paired with it in the mapping. The maximum size is one.
* @param {boolean} request.validateOnly
* If true, the request is validated but not executed. Only errors are
* returned, not results.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.graduate_experiment.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_GraduateExperiment_async
*/
graduateExperiment(request?: protos.google.ads.googleads.v21.services.IGraduateExperimentRequest, options?: CallOptions): Promise<[
protos.google.protobuf.IEmpty,
protos.google.ads.googleads.v21.services.IGraduateExperimentRequest | undefined,
{} | undefined
]>;
graduateExperiment(request: protos.google.ads.googleads.v21.services.IGraduateExperimentRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IGraduateExperimentRequest | null | undefined, {} | null | undefined>): void;
graduateExperiment(request: protos.google.ads.googleads.v21.services.IGraduateExperimentRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IGraduateExperimentRequest | null | undefined, {} | null | undefined>): void;
/**
* Schedule an experiment. The in design campaign
* will be converted into a real campaign (called the experiment campaign)
* that will begin serving ads if successfully created.
*
* The experiment is scheduled immediately with status INITIALIZING.
* This method returns a long running operation that tracks the forking of the
* in design campaign. If the forking fails, a list of errors can be retrieved
* using the ListExperimentAsyncErrors method. The operation's
* metadata will be a string containing the resource name of the created
* experiment.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [DatabaseError]()
* [DateError]()
* [DateRangeError]()
* [FieldError]()
* [HeaderError]()
* [InternalError]()
* [QuotaError]()
* [RangeError]()
* [RequestError]()
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.resourceName
* Required. The scheduled experiment.
* @param {boolean} request.validateOnly
* If true, the request is validated but not executed. Only errors are
* returned, not results.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing
* a long running operation. Its `promise()` method returns a promise
* you can `await` for.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.schedule_experiment.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_ScheduleExperiment_async
*/
scheduleExperiment(request?: protos.google.ads.googleads.v21.services.IScheduleExperimentRequest, options?: CallOptions): Promise<[
LROperation<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IScheduleExperimentMetadata>,
protos.google.longrunning.IOperation | undefined,
{} | undefined
]>;
scheduleExperiment(request: protos.google.ads.googleads.v21.services.IScheduleExperimentRequest, options: CallOptions, callback: Callback<LROperation<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IScheduleExperimentMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
scheduleExperiment(request: protos.google.ads.googleads.v21.services.IScheduleExperimentRequest, callback: Callback<LROperation<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IScheduleExperimentMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
/**
* Check the status of the long running operation returned by `scheduleExperiment()`.
* @param {String} name
* The operation name that will be passed.
* @returns {Promise} - The promise which resolves to an object.
* The decoded operation object has result and metadata field to get information from.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.schedule_experiment.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_ScheduleExperiment_async
*/
checkScheduleExperimentProgress(name: string): Promise<LROperation<protos.google.protobuf.Empty, protos.google.ads.googleads.v21.services.ScheduleExperimentMetadata>>;
/**
* Promotes the trial campaign thus applying changes in the trial campaign
* to the base campaign.
* This method returns a long running operation that tracks the promotion of
* the experiment campaign. If it fails, a list of errors can be retrieved
* using the ListExperimentAsyncErrors method. The operation's
* metadata will be a string containing the resource name of the created
* experiment.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [QuotaError]()
* [RequestError]()
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.resourceName
* Required. The resource name of the experiment to promote.
* @param {boolean} request.validateOnly
* If true, the request is validated but not executed. Only errors are
* returned, not results.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is an object representing
* a long running operation. Its `promise()` method returns a promise
* you can `await` for.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.promote_experiment.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_PromoteExperiment_async
*/
promoteExperiment(request?: protos.google.ads.googleads.v21.services.IPromoteExperimentRequest, options?: CallOptions): Promise<[
LROperation<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IPromoteExperimentMetadata>,
protos.google.longrunning.IOperation | undefined,
{} | undefined
]>;
promoteExperiment(request: protos.google.ads.googleads.v21.services.IPromoteExperimentRequest, options: CallOptions, callback: Callback<LROperation<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IPromoteExperimentMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
promoteExperiment(request: protos.google.ads.googleads.v21.services.IPromoteExperimentRequest, callback: Callback<LROperation<protos.google.protobuf.IEmpty, protos.google.ads.googleads.v21.services.IPromoteExperimentMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
/**
* Check the status of the long running operation returned by `promoteExperiment()`.
* @param {String} name
* The operation name that will be passed.
* @returns {Promise} - The promise which resolves to an object.
* The decoded operation object has result and metadata field to get information from.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.promote_experiment.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_PromoteExperiment_async
*/
checkPromoteExperimentProgress(name: string): Promise<LROperation<protos.google.protobuf.Empty, protos.google.ads.googleads.v21.services.PromoteExperimentMetadata>>;
/**
* Returns all errors that occurred during the last Experiment update (either
* scheduling or promotion).
* Supports standard list paging.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [HeaderError]()
* [InternalError]()
* [QuotaError]()
* [RequestError]()
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.resourceName
* Required. The name of the experiment from which to retrieve the async
* errors.
* @param {string} request.pageToken
* Token of the page to retrieve. If not specified, the first
* page of results will be returned. Use the value obtained from
* `next_page_token` in the previous response in order to request
* the next page of results.
* @param {number} request.pageSize
* Number of elements to retrieve in a single page.
* When a page request is too large, the server may decide to
* further limit the number of returned resources.
* The maximum page size is 1000.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Promise} - The promise which resolves to an array.
* The first element of the array is Array of {@link protos.google.rpc.Status|Status}.
* The client library will perform auto-pagination by default: it will call the API as many
* times as needed and will merge results from all the pages into this array.
* Note that it can affect your quota.
* We recommend using `listExperimentAsyncErrorsAsync()`
* method described below for async iteration which you can stop as needed.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
*/
listExperimentAsyncErrors(request?: protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest, options?: CallOptions): Promise<[
protos.google.rpc.IStatus[],
protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest | null,
protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsResponse
]>;
listExperimentAsyncErrors(request: protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest, options: CallOptions, callback: PaginationCallback<protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest, protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsResponse | null | undefined, protos.google.rpc.IStatus>): void;
listExperimentAsyncErrors(request: protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest, callback: PaginationCallback<protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest, protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsResponse | null | undefined, protos.google.rpc.IStatus>): void;
/**
* Equivalent to `listExperimentAsyncErrors`, but returns a NodeJS Stream object.
* @param {Object} request
* The request object that will be sent.
* @param {string} request.resourceName
* Required. The name of the experiment from which to retrieve the async
* errors.
* @param {string} request.pageToken
* Token of the page to retrieve. If not specified, the first
* page of results will be returned. Use the value obtained from
* `next_page_token` in the previous response in order to request
* the next page of results.
* @param {number} request.pageSize
* Number of elements to retrieve in a single page.
* When a page request is too large, the server may decide to
* further limit the number of returned resources.
* The maximum page size is 1000.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Stream}
* An object stream which emits an object representing {@link protos.google.rpc.Status|Status} on 'data' event.
* The client library will perform auto-pagination by default: it will call the API as many
* times as needed. Note that it can affect your quota.
* We recommend using `listExperimentAsyncErrorsAsync()`
* method described below for async iteration which you can stop as needed.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
*/
listExperimentAsyncErrorsStream(request?: protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest, options?: CallOptions): Transform;
/**
* Equivalent to `listExperimentAsyncErrors`, but returns an iterable object.
*
* `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
* @param {Object} request
* The request object that will be sent.
* @param {string} request.resourceName
* Required. The name of the experiment from which to retrieve the async
* errors.
* @param {string} request.pageToken
* Token of the page to retrieve. If not specified, the first
* page of results will be returned. Use the value obtained from
* `next_page_token` in the previous response in order to request
* the next page of results.
* @param {number} request.pageSize
* Number of elements to retrieve in a single page.
* When a page request is too large, the server may decide to
* further limit the number of returned resources.
* The maximum page size is 1000.
* @param {object} [options]
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
* @returns {Object}
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
* When you iterate the returned iterable, each element will be an object representing
* {@link protos.google.rpc.Status|Status}. The API will be called under the hood as needed, once per the page,
* so you can stop the iteration when you don't need more results.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v21/experiment_service.list_experiment_async_errors.js</caption>
* region_tag:googleads_v21_generated_ExperimentService_ListExperimentAsyncErrors_async
*/
listExperimentAsyncErrorsAsync(request?: protos.google.ads.googleads.v21.services.IListExperimentAsyncErrorsRequest, options?: CallOptions): AsyncIterable<protos.google.rpc.IStatus>;
/**
* Return a fully-qualified accessibleBiddingStrategy resource name string.
*
* @param {string} customer_id
* @param {string} bidding_strategy_id
* @returns {string} Resource name string.
*/
accessibleBiddingStrategyPath(customerId: string, biddingStrategyId: string): string;
/**
* Parse the customer_id from AccessibleBiddingStrategy resource.
*
* @param {string} accessibleBiddingStrategyName
* A fully-qualified path representing AccessibleBiddingStrategy resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAccessibleBiddingStrategyName(accessibleBiddingStrategyName: string): string | number;
/**
* Parse the bidding_strategy_id from AccessibleBiddingStrategy resource.
*
* @param {string} accessibleBiddingStrategyName
* A fully-qualified path representing AccessibleBiddingStrategy resource.
* @returns {string} A string representing the bidding_strategy_id.
*/
matchBiddingStrategyIdFromAccessibleBiddingStrategyName(accessibleBiddingStrategyName: string): string | number;
/**
* Return a fully-qualified accountBudget resource name string.
*
* @param {string} customer_id
* @param {string} account_budget_id
* @returns {string} Resource name string.
*/
accountBudgetPath(customerId: string, accountBudgetId: string): string;
/**
* Parse the customer_id from AccountBudget resource.
*
* @param {string} accountBudgetName
* A fully-qualified path representing AccountBudget resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAccountBudgetName(accountBudgetName: string): string | number;
/**
* Parse the account_budget_id from AccountBudget resource.
*
* @param {string} accountBudgetName
* A fully-qualified path representing AccountBudget resource.
* @returns {string} A string representing the account_budget_id.
*/
matchAccountBudgetIdFromAccountBudgetName(accountBudgetName: string): string | number;
/**
* Return a fully-qualified accountBudgetProposal resource name string.
*
* @param {string} customer_id
* @param {string} account_budget_proposal_id
* @returns {string} Resource name string.
*/
accountBudgetProposalPath(customerId: string, accountBudgetProposalId: string): string;
/**
* Parse the customer_id from AccountBudgetProposal resource.
*
* @param {string} accountBudgetProposalName
* A fully-qualified path representing AccountBudgetProposal resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAccountBudgetProposalName(accountBudgetProposalName: string): string | number;
/**
* Parse the account_budget_proposal_id from AccountBudgetProposal resource.
*
* @param {string} accountBudgetProposalName
* A fully-qualified path representing AccountBudgetProposal resource.
* @returns {string} A string representing the account_budget_proposal_id.
*/
matchAccountBudgetProposalIdFromAccountBudgetProposalName(accountBudgetProposalName: string): string | number;
/**
* Return a fully-qualified accountLink resource name string.
*
* @param {string} customer_id
* @param {string} account_link_id
* @returns {string} Resource name string.
*/
accountLinkPath(customerId: string, accountLinkId: string): string;
/**
* Parse the customer_id from AccountLink resource.
*
* @param {string} accountLinkName
* A fully-qualified path representing AccountLink resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAccountLinkName(accountLinkName: string): string | number;
/**
* Parse the account_link_id from AccountLink resource.
*
* @param {string} accountLinkName
* A fully-qualified path representing AccountLink resource.
* @returns {string} A string representing the account_link_id.
*/
matchAccountLinkIdFromAccountLinkName(accountLinkName: string): string | number;
/**
* Return a fully-qualified ad resource name string.
*
* @param {string} customer_id
* @param {string} ad_id
* @returns {string} Resource name string.
*/
adPath(customerId: string, adId: string): string;
/**
* Parse the customer_id from Ad resource.
*
* @param {string} adName
* A fully-qualified path representing Ad resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdName(adName: string): string | number;
/**
* Parse the ad_id from Ad resource.
*
* @param {string} adName
* A fully-qualified path representing Ad resource.
* @returns {string} A string representing the ad_id.
*/
matchAdIdFromAdName(adName: string): string | number;
/**
* Return a fully-qualified adGroup resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @returns {string} Resource name string.
*/
adGroupPath(customerId: string, adGroupId: string): string;
/**
* Parse the customer_id from AdGroup resource.
*
* @param {string} adGroupName
* A fully-qualified path representing AdGroup resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupName(adGroupName: string): string | number;
/**
* Parse the ad_group_id from AdGroup resource.
*
* @param {string} adGroupName
* A fully-qualified path representing AdGroup resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupName(adGroupName: string): string | number;
/**
* Return a fully-qualified adGroupAd resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} ad_id
* @returns {string} Resource name string.
*/
adGroupAdPath(customerId: string, adGroupId: string, adId: string): string;
/**
* Parse the customer_id from AdGroupAd resource.
*
* @param {string} adGroupAdName
* A fully-qualified path representing AdGroupAd resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupAdName(adGroupAdName: string): string | number;
/**
* Parse the ad_group_id from AdGroupAd resource.
*
* @param {string} adGroupAdName
* A fully-qualified path representing AdGroupAd resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupAdName(adGroupAdName: string): string | number;
/**
* Parse the ad_id from AdGroupAd resource.
*
* @param {string} adGroupAdName
* A fully-qualified path representing AdGroupAd resource.
* @returns {string} A string representing the ad_id.
*/
matchAdIdFromAdGroupAdName(adGroupAdName: string): string | number;
/**
* Return a fully-qualified adGroupAdAssetCombinationView resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} ad_id
* @param {string} asset_combination_id_low
* @param {string} asset_combination_id_high
* @returns {string} Resource name string.
*/
adGroupAdAssetCombinationViewPath(customerId: string, adGroupId: string, adId: string, assetCombinationIdLow: string, assetCombinationIdHigh: string): string;
/**
* Parse the customer_id from AdGroupAdAssetCombinationView resource.
*
* @param {string} adGroupAdAssetCombinationViewName
* A fully-qualified path representing AdGroupAdAssetCombinationView resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupAdAssetCombinationViewName(adGroupAdAssetCombinationViewName: string): string | number;
/**
* Parse the ad_group_id from AdGroupAdAssetCombinationView resource.
*
* @param {string} adGroupAdAssetCombinationViewName
* A fully-qualified path representing AdGroupAdAssetCombinationView resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupAdAssetCombinationViewName(adGroupAdAssetCombinationViewName: string): string | number;
/**
* Parse the ad_id from AdGroupAdAssetCombinationView resource.
*
* @param {string} adGroupAdAssetCombinationViewName
* A fully-qualified path representing AdGroupAdAssetCombinationView resource.
* @returns {string} A string representing the ad_id.
*/
matchAdIdFromAdGroupAdAssetCombinationViewName(adGroupAdAssetCombinationViewName: string): string | number;
/**
* Parse the asset_combination_id_low from AdGroupAdAssetCombinationView resource.
*
* @param {string} adGroupAdAssetCombinationViewName
* A fully-qualified path representing AdGroupAdAssetCombinationView resource.
* @returns {string} A string representing the asset_combination_id_low.
*/
matchAssetCombinationIdLowFromAdGroupAdAssetCombinationViewName(adGroupAdAssetCombinationViewName: string): string | number;
/**
* Parse the asset_combination_id_high from AdGroupAdAssetCombinationView resource.
*
* @param {string} adGroupAdAssetCombinationViewName
* A fully-qualified path representing AdGroupAdAssetCombinationView resource.
* @returns {string} A string representing the asset_combination_id_high.
*/
matchAssetCombinationIdHighFromAdGroupAdAssetCombinationViewName(adGroupAdAssetCombinationViewName: string): string | number;
/**
* Return a fully-qualified adGroupAdAssetView resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} ad_id
* @param {string} asset_id
* @param {string} field_type
* @returns {string} Resource name string.
*/
adGroupAdAssetViewPath(customerId: string, adGroupId: string, adId: string, assetId: string, fieldType: string): string;
/**
* Parse the customer_id from AdGroupAdAssetView resource.
*
* @param {string} adGroupAdAssetViewName
* A fully-qualified path representing AdGroupAdAssetView resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupAdAssetViewName(adGroupAdAssetViewName: string): string | number;
/**
* Parse the ad_group_id from AdGroupAdAssetView resource.
*
* @param {string} adGroupAdAssetViewName
* A fully-qualified path representing AdGroupAdAssetView resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupAdAssetViewName(adGroupAdAssetViewName: string): string | number;
/**
* Parse the ad_id from AdGroupAdAssetView resource.
*
* @param {string} adGroupAdAssetViewName
* A fully-qualified path representing AdGroupAdAssetView resource.
* @returns {string} A string representing the ad_id.
*/
matchAdIdFromAdGroupAdAssetViewName(adGroupAdAssetViewName: string): string | number;
/**
* Parse the asset_id from AdGroupAdAssetView resource.
*
* @param {string} adGroupAdAssetViewName
* A fully-qualified path representing AdGroupAdAssetView resource.
* @returns {string} A string representing the asset_id.
*/
matchAssetIdFromAdGroupAdAssetViewName(adGroupAdAssetViewName: string): string | number;
/**
* Parse the field_type from AdGroupAdAssetView resource.
*
* @param {string} adGroupAdAssetViewName
* A fully-qualified path representing AdGroupAdAssetView resource.
* @returns {string} A string representing the field_type.
*/
matchFieldTypeFromAdGroupAdAssetViewName(adGroupAdAssetViewName: string): string | number;
/**
* Return a fully-qualified adGroupAdLabel resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} ad_id
* @param {string} label_id
* @returns {string} Resource name string.
*/
adGroupAdLabelPath(customerId: string, adGroupId: string, adId: string, labelId: string): string;
/**
* Parse the customer_id from AdGroupAdLabel resource.
*
* @param {string} adGroupAdLabelName
* A fully-qualified path representing AdGroupAdLabel resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupAdLabelName(adGroupAdLabelName: string): string | number;
/**
* Parse the ad_group_id from AdGroupAdLabel resource.
*
* @param {string} adGroupAdLabelName
* A fully-qualified path representing AdGroupAdLabel resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupAdLabelName(adGroupAdLabelName: string): string | number;
/**
* Parse the ad_id from AdGroupAdLabel resource.
*
* @param {string} adGroupAdLabelName
* A fully-qualified path representing AdGroupAdLabel resource.
* @returns {string} A string representing the ad_id.
*/
matchAdIdFromAdGroupAdLabelName(adGroupAdLabelName: string): string | number;
/**
* Parse the label_id from AdGroupAdLabel resource.
*
* @param {string} adGroupAdLabelName
* A fully-qualified path representing AdGroupAdLabel resource.
* @returns {string} A string representing the label_id.
*/
matchLabelIdFromAdGroupAdLabelName(adGroupAdLabelName: string): string | number;
/**
* Return a fully-qualified adGroupAsset resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} asset_id
* @param {string} field_type
* @returns {string} Resource name string.
*/
adGroupAssetPath(customerId: string, adGroupId: string, assetId: string, fieldType: string): string;
/**
* Parse the customer_id from AdGroupAsset resource.
*
* @param {string} adGroupAssetName
* A fully-qualified path representing AdGroupAsset resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupAssetName(adGroupAssetName: string): string | number;
/**
* Parse the ad_group_id from AdGroupAsset resource.
*
* @param {string} adGroupAssetName
* A fully-qualified path representing AdGroupAsset resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupAssetName(adGroupAssetName: string): string | number;
/**
* Parse the asset_id from AdGroupAsset resource.
*
* @param {string} adGroupAssetName
* A fully-qualified path representing AdGroupAsset resource.
* @returns {string} A string representing the asset_id.
*/
matchAssetIdFromAdGroupAssetName(adGroupAssetName: string): string | number;
/**
* Parse the field_type from AdGroupAsset resource.
*
* @param {string} adGroupAssetName
* A fully-qualified path representing AdGroupAsset resource.
* @returns {string} A string representing the field_type.
*/
matchFieldTypeFromAdGroupAssetName(adGroupAssetName: string): string | number;
/**
* Return a fully-qualified adGroupAssetSet resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} asset_set_id
* @returns {string} Resource name string.
*/
adGroupAssetSetPath(customerId: string, adGroupId: string, assetSetId: string): string;
/**
* Parse the customer_id from AdGroupAssetSet resource.
*
* @param {string} adGroupAssetSetName
* A fully-qualified path representing AdGroupAssetSet resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupAssetSetName(adGroupAssetSetName: string): string | number;
/**
* Parse the ad_group_id from AdGroupAssetSet resource.
*
* @param {string} adGroupAssetSetName
* A fully-qualified path representing AdGroupAssetSet resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupAssetSetName(adGroupAssetSetName: string): string | number;
/**
* Parse the asset_set_id from AdGroupAssetSet resource.
*
* @param {string} adGroupAssetSetName
* A fully-qualified path representing AdGroupAssetSet resource.
* @returns {string} A string representing the asset_set_id.
*/
matchAssetSetIdFromAdGroupAssetSetName(adGroupAssetSetName: string): string | number;
/**
* Return a fully-qualified adGroupAudienceView resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} criterion_id
* @returns {string} Resource name string.
*/
adGroupAudienceViewPath(customerId: string, adGroupId: string, criterionId: string): string;
/**
* Parse the customer_id from AdGroupAudienceView resource.
*
* @param {string} adGroupAudienceViewName
* A fully-qualified path representing AdGroupAudienceView resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupAudienceViewName(adGroupAudienceViewName: string): string | number;
/**
* Parse the ad_group_id from AdGroupAudienceView resource.
*
* @param {string} adGroupAudienceViewName
* A fully-qualified path representing AdGroupAudienceView resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupAudienceViewName(adGroupAudienceViewName: string): string | number;
/**
* Parse the criterion_id from AdGroupAudienceView resource.
*
* @param {string} adGroupAudienceViewName
* A fully-qualified path representing AdGroupAudienceView resource.
* @returns {string} A string representing the criterion_id.
*/
matchCriterionIdFromAdGroupAudienceViewName(adGroupAudienceViewName: string): string | number;
/**
* Return a fully-qualified adGroupBidModifier resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} criterion_id
* @returns {string} Resource name string.
*/
adGroupBidModifierPath(customerId: string, adGroupId: string, criterionId: string): string;
/**
* Parse the customer_id from AdGroupBidModifier resource.
*
* @param {string} adGroupBidModifierName
* A fully-qualified path representing AdGroupBidModifier resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupBidModifierName(adGroupBidModifierName: string): string | number;
/**
* Parse the ad_group_id from AdGroupBidModifier resource.
*
* @param {string} adGroupBidModifierName
* A fully-qualified path representing AdGroupBidModifier resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupBidModifierName(adGroupBidModifierName: string): string | number;
/**
* Parse the criterion_id from AdGroupBidModifier resource.
*
* @param {string} adGroupBidModifierName
* A fully-qualified path representing AdGroupBidModifier resource.
* @returns {string} A string representing the criterion_id.
*/
matchCriterionIdFromAdGroupBidModifierName(adGroupBidModifierName: string): string | number;
/**
* Return a fully-qualified adGroupCriterion resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} criterion_id
* @returns {string} Resource name string.
*/
adGroupCriterionPath(customerId: string, adGroupId: string, criterionId: string): string;
/**
* Parse the customer_id from AdGroupCriterion resource.
*
* @param {string} adGroupCriterionName
* A fully-qualified path representing AdGroupCriterion resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupCriterionName(adGroupCriterionName: string): string | number;
/**
* Parse the ad_group_id from AdGroupCriterion resource.
*
* @param {string} adGroupCriterionName
* A fully-qualified path representing AdGroupCriterion resource.
* @returns {string} A string representing the ad_group_id.
*/
matchAdGroupIdFromAdGroupCriterionName(adGroupCriterionName: string): string | number;
/**
* Parse the criterion_id from AdGroupCriterion resource.
*
* @param {string} adGroupCriterionName
* A fully-qualified path representing AdGroupCriterion resource.
* @returns {string} A string representing the criterion_id.
*/
matchCriterionIdFromAdGroupCriterionName(adGroupCriterionName: string): string | number;
/**
* Return a fully-qualified adGroupCriterionCustomizer resource name string.
*
* @param {string} customer_id
* @param {string} ad_group_id
* @param {string} criterion_id
* @param {string} customizer_attribute_id
* @returns {string} Resource name string.
*/
adGroupCriterionCustomizerPath(customerId: string, adGroupId: string, criterionId: string, customizerAttributeId: string): string;
/**
* Parse the customer_id from AdGroupCriterionCustomizer resource.
*
* @param {string} adGroupCriterionCustomizerName
* A fully-qualified path representing AdGroupCriterionCustomizer resource.
* @returns {string} A string representing the customer_id.
*/
matchCustomerIdFromAdGroupCriterionCustomizerName(adGroupCriterionCustomizerName: string): string | number;
/**
* Parse the ad_group_id from AdGroupCriterionCustomizer resource.
*
* @param {str