google-ads-api-client
Version:
A friendly and exhaustive client to the google-ads-api, code generated directly from google's published protobuf schema.
264 lines (263 loc) • 11.6 kB
TypeScript
import type { RpcTransport } from "@protobuf-ts/runtime-rpc";
import type { ServiceInfo } from "@protobuf-ts/runtime-rpc";
import type { PromoteExperimentRequest } from "./experiment_service";
import type { Operation } from "../../google/longrunning/operations";
import type { ScheduleExperimentRequest } from "./experiment_service";
import type { GraduateExperimentRequest } from "./experiment_service";
import type { ListExperimentAsyncErrorsResponse } from "./experiment_service";
import type { ListExperimentAsyncErrorsRequest } from "./experiment_service";
import type { Empty } from "../../google/protobuf/empty";
import type { EndExperimentRequest } from "./experiment_service";
import type { MutateExperimentsResponse } from "./experiment_service";
import type { MutateExperimentsRequest } from "./experiment_service";
import type { UnaryCall } from "@protobuf-ts/runtime-rpc";
import type { RpcOptions } from "@protobuf-ts/runtime-rpc";
/**
* Service to manage experiments.
*
* @generated from protobuf service google.ads.googleads.v11.services.ExperimentService
*/
export interface IExperimentServiceClient {
/**
* Creates, updates, or removes experiments. Operation statuses are returned.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [QuotaError]()
* [RequestError]()
*
* @generated from protobuf rpc: MutateExperiments(google.ads.googleads.v11.services.MutateExperimentsRequest) returns (google.ads.googleads.v11.services.MutateExperimentsResponse);
*/
mutateExperiments(input: MutateExperimentsRequest, options?: RpcOptions): UnaryCall<MutateExperimentsRequest, MutateExperimentsResponse>;
/**
* 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]()
*
* @generated from protobuf rpc: EndExperiment(google.ads.googleads.v11.services.EndExperimentRequest) returns (google.protobuf.Empty);
*/
endExperiment(input: EndExperimentRequest, options?: RpcOptions): UnaryCall<EndExperimentRequest, Empty>;
/**
* 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]()
*
* @generated from protobuf rpc: ListExperimentAsyncErrors(google.ads.googleads.v11.services.ListExperimentAsyncErrorsRequest) returns (google.ads.googleads.v11.services.ListExperimentAsyncErrorsResponse);
*/
listExperimentAsyncErrors(input: ListExperimentAsyncErrorsRequest, options?: RpcOptions): UnaryCall<ListExperimentAsyncErrorsRequest, ListExperimentAsyncErrorsResponse>;
/**
* Graduates an experiment to a full campaign.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [MutateError]()
* [QuotaError]()
* [RequestError]()
*
* @generated from protobuf rpc: GraduateExperiment(google.ads.googleads.v11.services.GraduateExperimentRequest) returns (google.protobuf.Empty);
*/
graduateExperiment(input: GraduateExperimentRequest, options?: RpcOptions): UnaryCall<GraduateExperimentRequest, Empty>;
/**
* 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]()
*
* @generated from protobuf rpc: ScheduleExperiment(google.ads.googleads.v11.services.ScheduleExperimentRequest) returns (google.longrunning.Operation);
*/
scheduleExperiment(input: ScheduleExperimentRequest, options?: RpcOptions): UnaryCall<ScheduleExperimentRequest, Operation>;
/**
* 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]()
*
* @generated from protobuf rpc: PromoteExperiment(google.ads.googleads.v11.services.PromoteExperimentRequest) returns (google.longrunning.Operation);
*/
promoteExperiment(input: PromoteExperimentRequest, options?: RpcOptions): UnaryCall<PromoteExperimentRequest, Operation>;
}
/**
* Service to manage experiments.
*
* @generated from protobuf service google.ads.googleads.v11.services.ExperimentService
*/
export declare class ExperimentServiceClient implements IExperimentServiceClient, ServiceInfo {
private readonly _transport;
typeName: string;
methods: import("@protobuf-ts/runtime-rpc").MethodInfo<any, any>[];
options: {
[extensionName: string]: import("@protobuf-ts/runtime").JsonValue;
};
constructor(_transport: RpcTransport);
/**
* Creates, updates, or removes experiments. Operation statuses are returned.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [QuotaError]()
* [RequestError]()
*
* @generated from protobuf rpc: MutateExperiments(google.ads.googleads.v11.services.MutateExperimentsRequest) returns (google.ads.googleads.v11.services.MutateExperimentsResponse);
*/
mutateExperiments(input: MutateExperimentsRequest, options?: RpcOptions): UnaryCall<MutateExperimentsRequest, MutateExperimentsResponse>;
/**
* 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]()
*
* @generated from protobuf rpc: EndExperiment(google.ads.googleads.v11.services.EndExperimentRequest) returns (google.protobuf.Empty);
*/
endExperiment(input: EndExperimentRequest, options?: RpcOptions): UnaryCall<EndExperimentRequest, Empty>;
/**
* 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]()
*
* @generated from protobuf rpc: ListExperimentAsyncErrors(google.ads.googleads.v11.services.ListExperimentAsyncErrorsRequest) returns (google.ads.googleads.v11.services.ListExperimentAsyncErrorsResponse);
*/
listExperimentAsyncErrors(input: ListExperimentAsyncErrorsRequest, options?: RpcOptions): UnaryCall<ListExperimentAsyncErrorsRequest, ListExperimentAsyncErrorsResponse>;
/**
* Graduates an experiment to a full campaign.
*
* List of thrown errors:
* [AuthenticationError]()
* [AuthorizationError]()
* [ExperimentError]()
* [HeaderError]()
* [InternalError]()
* [MutateError]()
* [QuotaError]()
* [RequestError]()
*
* @generated from protobuf rpc: GraduateExperiment(google.ads.googleads.v11.services.GraduateExperimentRequest) returns (google.protobuf.Empty);
*/
graduateExperiment(input: GraduateExperimentRequest, options?: RpcOptions): UnaryCall<GraduateExperimentRequest, Empty>;
/**
* 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]()
*
* @generated from protobuf rpc: ScheduleExperiment(google.ads.googleads.v11.services.ScheduleExperimentRequest) returns (google.longrunning.Operation);
*/
scheduleExperiment(input: ScheduleExperimentRequest, options?: RpcOptions): UnaryCall<ScheduleExperimentRequest, Operation>;
/**
* 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]()
*
* @generated from protobuf rpc: PromoteExperiment(google.ads.googleads.v11.services.PromoteExperimentRequest) returns (google.longrunning.Operation);
*/
promoteExperiment(input: PromoteExperimentRequest, options?: RpcOptions): UnaryCall<PromoteExperimentRequest, Operation>;
}