Gcp/curationpartners

@swamp/gcp/curationpartnersv2026.10.23.1· AGPL-3.0-or-later· 3d agoBEHAVIORS

01README

Google Cloud curationpartners infrastructure models

02Release Notes

Updated: curators_curatedpackages, curators_datasegments, curators_reports, mediaplanners

03Behaviors4

@swamp/gcp/curationpartners/curators-curatedpackagesv2026.10.23.1curators_curatedpackages.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
accessSettings?	object	no	Required. Settings for controlling access to the curated package. Access to this curated package is limited to the allowlisted media planners and the creator. Buyers and bidders can not be allowlisted for or have direct access to this resource.
curationFeeVisibility?	enum	no	Optional. Immutable. The visibility of the combined curation package fee and data segment fees (the total curation fee).
description?	string	no	Optional. A description of the curated package, provided by the curator.
displayName?	string	no	Required. The display name assigned to the curated package by the curator. Can be used to filter the response of the curatedPackages.list method.
feeCpm?	object	no	Optional. The CPM fee charged by the curator to buyers using this curated package. Can be used to filter the response of the curatedPackages.list method.
floorPriceCpm?	object	no	Optional. The minimum CPM a buyer has to bid to participate in auctions for inventory in this curated package. Can be used to filter the response of the curatedPackages.list method.
millipercentOfMediaFee?	string	no	Optional. The fee will be charged as a percentage of the impression cost, represented in millipercent. For example, 1% is represented as 1000.
name?	string	no	Identifier. The unique resource name for the curated package. Format: `curators/{accountId}/curatedPackages/{curatedPackageId}`
targeting?	object	no	Optional. Targeting criteria for the curated package.
parent?	string	no	The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)

fn create(waitForReady?: boolean)

Create a curatedPackages

Argument	Type	Required	Description
waitForReady?	boolean	no	Wait for the resource to reach a ready state after creation (default: true)

fn get(identifier: string)

Get a curatedPackages

Argument	Type	Required	Description
identifier	string	yes	The name of the curatedPackages

fn update(identifier?: string, waitForReady?: boolean)

Update curatedPackages attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific curatedPackages by name (e.g. one discovered by list)
waitForReady?	boolean	no	Wait for the resource to reach a ready state after update (default: true)

fn sync(identifier?: string)

Sync curatedPackages state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific curatedPackages by name (e.g. one discovered by list)

fn list(filter?: string, pageSize?: number, maxPages?: number)

List curatedPackages resources

Argument	Type	Required	Description
filter?	string	no	Optional. Optional query string using the [Cloud API list filtering syntax](/authorized-buyers/apis/guides/list-filters). Supported columns for filtering are: * displayName * createTime * updateTime * state * feeCpm.currencyCode * feeCpm.units * feeCpm.nanos * floorPriceCpm.currencyCode * floorPriceCpm.units * floorPriceCpm.nanos
pageSize?	number	no	Optional. Requested page size. The server may return fewer results than requested. Max allowed page size is 500. If unspecified, the server will default to 500.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn activate()

activate

fn deactivate()

deactivate

Resources

state(infinite)— Represents a curated package of inventory created and managed by a Curator.

@swamp/gcp/curationpartners/curators-datasegmentsv2026.10.23.1curators_datasegments.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
cpmFee?	object	no	Optional. A fixed fee charged per thousand impressions. Once set, the currency code cannot be changed.
millipercentOfMediaFee?	string	no	Optional. The fee will be charged as a percentage of the impression cost, represented in millipercent. For example, 1% is represented as 1000.
name?	string	no	Immutable. Identifier. The unique identifier for the data segment. Account ID corresponds to the account ID that created the segment. Format: `curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}`
userListId?	string	no	Optional. Immutable. The ID of the User List wrapped by this Data Segment. Curators with a linked Data Partner account can create a data segment that wraps a user list owned by the linked Data Partner account. User lists can be uploaded and managed using the [Data Manager API](https://developers.google.com/data-manager/api/data-partners/audiences). Linking a user list to a data segment lets you define a segment of inventory that is based on an audience you create.
parent?	string	no	The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)

fn create(waitForReady?: boolean)

Create a dataSegments

Argument	Type	Required	Description
waitForReady?	boolean	no	Wait for the resource to reach a ready state after creation (default: true)

fn get(identifier: string)

Get a dataSegments

Argument	Type	Required	Description
identifier	string	yes	The name of the dataSegments

fn update(identifier?: string, waitForReady?: boolean)

Update dataSegments attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific dataSegments by name (e.g. one discovered by list)
waitForReady?	boolean	no	Wait for the resource to reach a ready state after update (default: true)

fn sync(identifier?: string)

Sync dataSegments state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific dataSegments by name (e.g. one discovered by list)

fn list(pageSize?: number, maxPages?: number)

List dataSegments resources

Argument	Type	Required	Description
pageSize?	number	no	Optional. Requested page size. The server may return fewer results than requested. Max allowed page size is 500. If unspecified, the server will default to 500.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn activate()

activate

fn deactivate()

deactivate

Resources

state(infinite)— Defines an identifier for a segment of inventory that can be targeted by cura...

@swamp/gcp/curationpartners/curators-reportsv2026.10.23.1curators_reports.ts

Global Arguments

Argument	Type	Required	Description
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.
displayName?	string	no	Optional. Display name for the report.
name?	string	no	Identifier. The resource name of the report. Report resource name have the form: `curators/{account_id}/reports/{report_id}`
reportDefinition?	object	no	Required. The report definition of the report.
parent?	string	no	The parent resource name (e.g., projects/my-project/locations/us-central1, organizations/123, folders/456)

fn create()

Create a reports

fn get(identifier: string)

Get a reports

Argument	Type	Required	Description
identifier	string	yes	The name of the reports

fn update(identifier?: string)

Update reports attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific reports by name (e.g. one discovered by list)

fn delete(identifier: string)

Delete the reports

Argument	Type	Required	Description
identifier	string	yes	The name of the reports

fn sync(identifier?: string)

Sync reports state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific reports by name (e.g. one discovered by list)

fn list(filter?: string, orderBy?: string, pageSize?: number, skip?: number, maxPages?: number)

List reports resources

Argument	Type	Required	Description
filter?	string	no	Optional. Expression to filter the response. See syntax details at https://developers.google.com/ad-manager/api/beta/filters
orderBy?	string	no	Optional. Expression to specify sorting order. See syntax details at https://developers.google.com/ad-manager/api/beta/filters#order
pageSize?	number	no	Optional. The maximum number of `Reports` to return. The service may return fewer than this value. If unspecified, at most 50 `Reports` will be returned. The maximum value is 1000; values greater than 1000 will be coerced to 1000.
skip?	number	no	Optional. Number of individual resources to skip while paginating.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn run()

run

Resources

state(infinite)— The `Report` resource.

@swamp/gcp/curationpartners/mediaplannersv2026.10.23.1mediaplanners.ts

Global Arguments

Argument	Type	Required	Description
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
accessToken?	string	no	GCP OAuth2 access token; overrides GCP_ACCESS_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
credentialsJson?	string	no	GCP service account JSON credentials; overrides GOOGLE_APPLICATION_CREDENTIALS_JSON environment variable. Wire with a vault.get(...) expression to source it from a vault.
project?	string	no	GCP project ID; overrides GCP_PROJECT / GOOGLE_CLOUD_PROJECT environment variables.
scopes?	string	no	Comma-separated OAuth scopes to request when minting access tokens via gcloud. Defaults to the API's Discovery Document scopes.
quotaProject?	string	no	GCP project ID for quota and billing attribution; sets the x-goog-user-project header. Overrides GOOGLE_CLOUD_QUOTA_PROJECT environment variable. Required for APIs like Cloud Identity when using user credentials.
apiEndpoint?	string	no	Custom API endpoint for emulators; overrides GCP_API_ENDPOINT environment variable. Defaults to the service's production URL.

fn get(identifier: string)

Get a mediaPlanners

Argument	Type	Required	Description
identifier	string	yes	The name of the mediaPlanners

fn sync(identifier?: string)

Sync mediaPlanners state from GCP

Argument	Type	Required	Description
identifier?	string	no	Target a specific mediaPlanners by name (e.g. one discovered by list)

fn list(filter?: string, pageSize?: number, maxPages?: number)

List mediaPlanners resources

Argument	Type	Required	Description
filter?	string	no	Optional query string using the [Cloud API list filtering syntax](/authorized-buyers/apis/guides/list-filters). Supported columns for filtering are: * `name` * `displayName` * `ancestorNames`
pageSize?	number	no	The maximum number of media planners to return. If unspecified, at most 100 media planners will be returned. The maximum value is 500; values above 500 will be coerced to 500.
maxPages?	number	no	Maximum number of pages to fetch (default: 10)

fn search(dspSeatId?: any, pageSize?: any, pageToken?: any)

Argument	Type	Required
dspSeatId?	any	no
pageSize?	any	no
pageToken?	any	no

Resources

state(infinite)— Represents a media planner account.

04Previous Versions3

2026.10.21.1AGPL-3.0-or-later(was none)Oct 21, 2026

Updated: mediaplanners

Modified 1 behaviors

2026.10.13.1Oct 13, 2026

Updated: curators_curatedpackages, curators_datasegments, curators_reports, mediaplanners

2026.08.29.1Aug 29, 2026

Added: curators_curatedpackages, curators_datasegments, curators_reports, mediaplanners

05Stats

100 / 100

Downloads

Archive size

59.6 KB

Verified by Swamp

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Docs keep secrets in a vault1/1earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License2/2earned
Verified public repository2/2earned

Repository

https://github.com/swamp-club/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64 windows · x86_64

07Labels

#gcp #google-cloud #curationpartners #cloud #infrastructure