@niur/google-admanager-api
Version:
Google Ad Manager API Client Library for NodeJs
57 lines • 5.41 kB
TypeScript
import { Statement, UpdateResult } from '../../../common/types';
import { AudienceSegmentAction } from './audienceSegment.action';
import { AudienceSegmentPage, FirstPartyAudienceSegment } from './audienceSegment.type';
/**
* Provides operations for creating, updating and retrieving
* {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment AudienceSegment} objects.
*
*/
export interface AudienceSegmentServiceOperations {
/**
* Creates new {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.FirstPartyAudienceSegment FirstPartyAudienceSegment} objects.
*
* @param segments first-party audience segments to create
* @returns created first-party audience segments
*/
createAudienceSegments(segments: FirstPartyAudienceSegment[]): Promise<FirstPartyAudienceSegment[]>;
/**
* Gets an {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegmentPage AudienceSegmentPage}
* of {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment AudienceSegment}
* objects that satisfy the given {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.Statement#query Statement.query}.
* The following fields are supported for filtering:
*
* | PQL Property | PQL Property |
* | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
* | id | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment#id AudienceSegment.id} |
* | name | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment#name AudienceSegment.name} |
* | status | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment#status AudienceSegment.status} |
* | type | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment#type AudienceSegment.type} |
* | size | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment#size AudienceSegment.size} |
* | dataProviderName | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegmentDataProvider#name AudienceSegmentDataProvider.name} |
* | segmentType | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.AudienceSegment#type AudienceSegment.type} |
* | approvalStatus | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.ThirdPartyAudienceSegment#approvalStatus ThirdPartyAudienceSegment.approvalStatus} |
* | cost | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.ThirdPartyAudienceSegment#cost ThirdPartyAudienceSegment.cost} |
* | startDateTime | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.ThirdPartyAudienceSegment#startDateTime ThirdPartyAudienceSegment.startDateTime} |
* | endDateTime | {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.ThirdPartyAudienceSegment#endDateTime ThirdPartyAudienceSegment.endDateTime} |
*
* @param filterStatement a Publisher Query Language statement used to filter a set of audience segments (the only supported operator is AND)
* @returns the audience segments that match the given filter
*/
getAudienceSegmentsByStatement(filterStatement: Statement): Promise<AudienceSegmentPage>;
/**
* Performs the given AudienceSegmentAction on the set of segments identified by the given statement.
*
* @param action AudienceSegmentAction to perform
* @param filterStatement a Publisher Query Language statement used to filter a set of audience segments (the only supported operator is AND)
* @returns UpdateResult indicating the result
*/
performAudienceSegmentAction(action: AudienceSegmentAction, filterStatement: Statement): Promise<UpdateResult>;
/**
* Updates the given {@link https://developers.google.com/ad-manager/api/reference/v202202/AudienceSegmentService.FirstPartyAudienceSegment FirstPartyAudienceSegment} objects.
*
* @param segments first-party audience segments to update
* @returns updated first-party audience segments
*/
updateAudienceSegments(segments: FirstPartyAudienceSegment[]): Promise<FirstPartyAudienceSegment[]>;
}
//# sourceMappingURL=audienceSegmentService.interface.d.ts.map