@maxim_mazurok/gapi.client.datamanager-v1 0.0.20251006

package/index.d.ts

@@ -0,0 +1,557 @@
+/* Type definitions for non-npm package Data Manager API v1 0.0 */
+// Project: https://developers.google.com/data-manager
+// Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
+//                 Nick Amoscato <https://github.com/namoscato>
+//                 Declan Vong <https://github.com/declanvong>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+// IMPORTANT
+// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
+// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
+// Generated from: https://datamanager.googleapis.com/$discovery/rest?version=v1
+// Revision: 20251006
+
+/// <reference types="gapi.client" />
+
+declare namespace gapi.client {
+  /** Load Data Manager API v1 */
+  function load(
+    urlOrObject: 'https://datamanager.googleapis.com/$discovery/rest?version=v1',
+  ): Promise<void>;
+  /** @deprecated Please load APIs with discovery documents. */
+  function load(name: 'datamanager', version: 'v1'): Promise<void>;
+  /** @deprecated Please load APIs with discovery documents. */
+  function load(name: 'datamanager', version: 'v1', callback: () => any): void;
+
+  namespace datamanager {
+    interface AddressInfo {
+      /** Required. Family (last) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256. */
+      familyName?: string;
+      /** Required. Given (first) name of the user, all lowercase, with no punctuation, no leading or trailing whitespace, and hashed as SHA-256. */
+      givenName?: string;
+      /** Required. The postal code of the user's address. */
+      postalCode?: string;
+      /** Required. The 2-letter region code in ISO-3166-1 alpha-2 of the user's address. */
+      regionCode?: string;
+    }
+    interface AdIdentifiers {
+      /** Optional. The click identifier for clicks associated with app events and originating from iOS devices starting with iOS14. */
+      gbraid?: string;
+      /** Optional. The Google click ID (gclid) associated with this event. */
+      gclid?: string;
+      /** Optional. Information gathered about the device being used (if any) at the time of landing onto the advertiser’s site after interacting with the ad. */
+      landingPageDeviceInfo?: DeviceInfo;
+      /** Optional. Session attributes for event attribution and modeling. */
+      sessionAttributes?: string;
+      /** Optional. The click identifier for clicks associated with web events and originating from iOS devices starting with iOS14. */
+      wbraid?: string;
+    }
+    interface AudienceMember {
+      /** Optional. The consent setting for the user. */
+      consent?: Consent;
+      /** Optional. Defines which Destination to send the audience member to. */
+      destinationReferences?: string[];
+      /** Data identifying the user's mobile devices. */
+      mobileData?: MobileData;
+      /** [Publisher Advertiser Identity Reconciliation (PAIR) IDs](//support.google.com/admanager/answer/15067908). */
+      pairData?: PairData;
+      /** User-provided data that identifies the user. */
+      userData?: UserData;
+    }
+    interface CartData {
+      /** Optional. The list of items associated with the event. */
+      items?: Item[];
+      /** Optional. The Merchant Center feed label associated with the feed of the items. */
+      merchantFeedLabel?: string;
+      /** Optional. The language code in ISO 639-1 associated with the Merchant Center feed of the items.where your items are uploaded. */
+      merchantFeedLanguageCode?: string;
+      /** Optional. The Merchant Center ID associated with the items. */
+      merchantId?: string;
+      /** Optional. The sum of all discounts associated with the transaction. */
+      transactionDiscount?: number;
+    }
+    interface Consent {
+      /** Optional. Represents if the user consents to ad personalization. */
+      adPersonalization?: string;
+      /** Optional. Represents if the user consents to ad user data. */
+      adUserData?: string;
+    }
+    interface CustomVariable {
+      /** Optional. Reference string used to determine which of the Event.destination_references the custom variable should be sent to. If empty, the Event.destination_references will be used. */
+      destinationReferences?: string[];
+      /** Optional. The value to store for the custom variable. */
+      value?: string;
+      /** Optional. The name of the custom variable to set. If the variable is not found for the given destination, it will be ignored. */
+      variable?: string;
+    }
+    interface Destination {
+      /** Optional. An account that the calling user's `login_account` has access to, through an established account link. For example, a data partner's `login_account` might have access to a client's `linked_account`. The partner might use this field to send data from the `linked_account` to another `operating_account`. */
+      linkedAccount?: ProductAccount;
+      /** Optional. The account used to make this API call. To add or remove data from the `operating_account`, this `login_account` must have write access to the `operating_account`. For example, a manager account of the `operating_account`, or an account with an established link to the `operating_account`. */
+      loginAccount?: ProductAccount;
+      /** Required. The account to send the data to or remove the data from. */
+      operatingAccount?: ProductAccount;
+      /** Required. The object within the product account to ingest into. For example, a Google Ads audience ID, a Display & Video 360 audience ID or a Google Ads conversion action ID. */
+      productDestinationId?: string;
+      /** Optional. ID for this `Destination` resource, unique within the request. Use to reference this `Destination` in the IngestEventsRequest and IngestAudienceMembersRequest. */
+      reference?: string;
+    }
+    interface DeviceInfo {
+      /** Optional. The IP address of the device for the given context. **Note:** Google Ads does not support IP address matching for end users in the European Economic Area (EEA), United Kingdom (UK), or Switzerland (CH). Add logic to conditionally exclude sharing IP addresses from users from these regions and ensure that you provide users with clear and comprehensive information about the data you collect on your sites, apps, and other properties and get consent where required by law or any applicable Google policies. See the [About offline conversion imports](https://support.google.com/google-ads/answer/2998031) page for more details. */
+      ipAddress?: string;
+      /** Optional. The user-agent string of the device for the given context. */
+      userAgent?: string;
+    }
+    interface EncryptionInfo {
+      /** Google Cloud Platform wrapped key information. */
+      gcpWrappedKeyInfo?: GcpWrappedKeyInfo;
+    }
+    interface ErrorCount {
+      /** The error reason of the failed records. */
+      reason?: string;
+      /** The count of records that failed to upload for a given reason. */
+      recordCount?: string;
+    }
+    interface ErrorInfo {
+      /** A list of errors and counts per error reason. May not be populated in all cases. */
+      errorCounts?: ErrorCount[];
+    }
+    interface Event {
+      /** Optional. Identifiers and other information used to match the conversion event with other online activity (such as ad clicks). */
+      adIdentifiers?: AdIdentifiers;
+      /** Optional. Information about the transaction and items associated with the event. */
+      cartData?: CartData;
+      /** Optional. Information about whether the associated user has provided different types of consent. */
+      consent?: Consent;
+      /** Optional. The conversion value associated with the event, for value-based conversions. */
+      conversionValue?: number;
+      /** Optional. The currency code associated with all monetary values within this event. */
+      currency?: string;
+      /** Optional. Additional key/value pair information to send to the conversion containers (conversion action or FL activity). */
+      customVariables?: CustomVariable[];
+      /** Optional. Reference string used to determine the destination. If empty, the event will be sent to all destinations in the request. */
+      destinationReferences?: string[];
+      /** Optional. Information gathered about the device being used (if any) when the event happened. */
+      eventDeviceInfo?: DeviceInfo;
+      /** Optional. Signal for where the event happened (web, app, in-store, etc.). */
+      eventSource?: string;
+      /** Required. The time the event occurred. */
+      eventTimestamp?: string;
+      /** Optional. A list of key/value pairs for experimental fields that may eventually be promoted to be part of the API. */
+      experimentalFields?: ExperimentalField[];
+      /** Optional. The last time the event was updated. */
+      lastUpdatedTimestamp?: string;
+      /** Optional. The unique identifier for this event. Required for conversions using multiple data sources. */
+      transactionId?: string;
+      /** Optional. Pieces of user provided data, representing the user the event is associated with. */
+      userData?: UserData;
+      /** Optional. Advertiser-assessed information about the user at the time that the event happened. */
+      userProperties?: UserProperties;
+    }
+    interface ExperimentalField {
+      /** Optional. The name of the field to use. */
+      field?: string;
+      /** Optional. The value the field to set. */
+      value?: string;
+    }
+    interface GcpWrappedKeyInfo {
+      /** Required. The base64 encoded encrypted data encryption key. */
+      encryptedDek?: string;
+      /** Required. Google Cloud Platform [Cloud Key Management Service resource ID](//cloud.google.com/kms/docs/getting-resource-ids). Should be in the format of "projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key}". */
+      kekUri?: string;
+      /** Required. The type of algorithm used to encrypt the data. */
+      keyType?: string;
+      /** Required. The [Workload Identity](//cloud.google.com/iam/docs/workload-identity-federation) pool provider required to use KEK. */
+      wipProvider?: string;
+    }
+    interface IngestAudienceMembersRequest {
+      /** Required. The list of users to send to the specified destinations. At most 10000 AudienceMember resources can be sent in a single request. */
+      audienceMembers?: AudienceMember[];
+      /** Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each AudienceMember. */
+      consent?: Consent;
+      /** Required. The list of destinations to send the audience members to. */
+      destinations?: Destination[];
+      /** Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non `UserData` uploads, this field is ignored. */
+      encoding?: string;
+      /** Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored. */
+      encryptionInfo?: EncryptionInfo;
+      /** Optional. The terms of service that the user has accepted/rejected. */
+      termsOfService?: TermsOfService;
+      /** Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results. */
+      validateOnly?: boolean;
+    }
+    interface IngestAudienceMembersResponse {
+      /** The auto-generated ID of the request. */
+      requestId?: string;
+    }
+    interface IngestAudienceMembersStatus {
+      /** The status of the mobile data ingestion to the destination. */
+      mobileDataIngestionStatus?: IngestMobileDataStatus;
+      /** The status of the pair data ingestion to the destination. */
+      pairDataIngestionStatus?: IngestPairDataStatus;
+      /** The status of the user data ingestion to the destination. */
+      userDataIngestionStatus?: IngestUserDataStatus;
+    }
+    interface IngestEventsRequest {
+      /** Optional. Request-level consent to apply to all users in the request. User-level consent overrides request-level consent, and can be specified in each Event. */
+      consent?: Consent;
+      /** Required. The list of destinations to send the events to. */
+      destinations?: Destination[];
+      /** Optional. Required for UserData uploads. The encoding type of the user identifiers. For hashed user identifiers, this is the encoding type of the hashed string. For encrypted hashed user identifiers, this is the encoding type of the outer encrypted string, but not necessarily the inner hashed string, meaning the inner hashed string could be encoded in a different way than the outer encrypted string. For non `UserData` uploads, this field is ignored. */
+      encoding?: string;
+      /** Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored. */
+      encryptionInfo?: EncryptionInfo;
+      /** Required. The list of events to send to the specified destinations. At most 2000 Event resources can be sent in a single request. */
+      events?: Event[];
+      /** Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results. */
+      validateOnly?: boolean;
+    }
+    interface IngestEventsResponse {
+      /** The auto-generated ID of the request. */
+      requestId?: string;
+    }
+    interface IngestEventsStatus {
+      /** The total count of events sent in the upload request. Includes all events in the request, regardless of whether they were successfully ingested or not. */
+      recordCount?: string;
+    }
+    interface IngestMobileDataStatus {
+      /** The total count of mobile ids sent in the upload request for the destination. Includes all mobile ids in the request, regardless of whether they were successfully ingested or not. */
+      mobileIdCount?: string;
+      /** The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not. */
+      recordCount?: string;
+    }
+    interface IngestPairDataStatus {
+      /** The total count of pair ids sent in the upload request for the destination. Includes all pair ids in the request, regardless of whether they were successfully ingested or not. */
+      pairIdCount?: string;
+      /** The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not. */
+      recordCount?: string;
+    }
+    interface IngestUserDataStatus {
+      /** The total count of audience members sent in the upload request for the destination. Includes all audience members in the request, regardless of whether they were successfully ingested or not. */
+      recordCount?: string;
+      /** The match rate range of the upload. */
+      uploadMatchRateRange?: string;
+      /** The total count of user identifiers sent in the upload request for the destination. Includes all user identifiers in the request, regardless of whether they were successfully ingested or not. */
+      userIdentifierCount?: string;
+    }
+    interface Item {
+      /** Optional. The product ID within the Merchant Center account. */
+      merchantProductId?: string;
+      /** Optional. The number of this item associated with the event. */
+      quantity?: string;
+      /** Optional. The unit price excluding tax, shipping, and any transaction level discounts. */
+      unitPrice?: number;
+    }
+    interface MobileData {
+      /** Required. The list of mobile device IDs (advertising ID/IDFA). At most 10 `mobileIds` can be provided in a single AudienceMember. */
+      mobileIds?: string[];
+    }
+    interface PairData {
+      /** Required. Cleanroom-provided PII data, hashed with SHA256, and encrypted with an EC commutative cipher using publisher key for the [PAIR]((//support.google.com/admanager/answer/15067908)) user list. At most 10 `pairIds` can be provided in a single AudienceMember. */
+      pairIds?: string[];
+    }
+    interface ProductAccount {
+      /** Required. The ID of the account. For example, your Google Ads account ID. */
+      accountId?: string;
+      /** Optional. The type of the account. For example, `GOOGLE_ADS`. Either `account_type` or the deprecated `product` is required. If both are set, the values must match. */
+      accountType?: string;
+      /** Deprecated. Use `account_type` instead. */
+      product?: string;
+    }
+    interface RemoveAudienceMembersRequest {
+      /** Required. The list of users to remove. */
+      audienceMembers?: AudienceMember[];
+      /** Required. The list of destinations to remove the users from. */
+      destinations?: Destination[];
+      /** Optional. Required for UserData uploads. The encoding type of the user identifiers. Applies to only the outer encoding for encrypted user identifiers. For non `UserData` uploads, this field is ignored. */
+      encoding?: string;
+      /** Optional. Encryption information for UserData uploads. If not set, it's assumed that uploaded identifying information is hashed but not encrypted. For non `UserData` uploads, this field is ignored. */
+      encryptionInfo?: EncryptionInfo;
+      /** Optional. For testing purposes. If `true`, the request is validated but not executed. Only errors are returned, not results. */
+      validateOnly?: boolean;
+    }
+    interface RemoveAudienceMembersResponse {
+      /** The auto-generated ID of the request. */
+      requestId?: string;
+    }
+    interface RemoveAudienceMembersStatus {
+      /** The status of the mobile data removal from the destination. */
+      mobileDataRemovalStatus?: RemoveMobileDataStatus;
+      /** The status of the pair data removal from the destination. */
+      pairDataRemovalStatus?: RemovePairDataStatus;
+      /** The status of the user data removal from the destination. */
+      userDataRemovalStatus?: RemoveUserDataStatus;
+    }
+    interface RemoveMobileDataStatus {
+      /** The total count of mobile Ids sent in the removal request. Includes all mobile ids in the request, regardless of whether they were successfully removed or not. */
+      mobileIdCount?: string;
+      /** The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not. */
+      recordCount?: string;
+    }
+    interface RemovePairDataStatus {
+      /** The total count of pair ids sent in the removal request. Includes all pair ids in the request, regardless of whether they were successfully removed or not. */
+      pairIdCount?: string;
+      /** The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not. */
+      recordCount?: string;
+    }
+    interface RemoveUserDataStatus {
+      /** The total count of audience members sent in the removal request. Includes all audience members in the request, regardless of whether they were successfully removed or not. */
+      recordCount?: string;
+      /** The total count of user identifiers sent in the removal request. Includes all user identifiers in the request, regardless of whether they were successfully removed or not. */
+      userIdentifierCount?: string;
+    }
+    interface RequestStatusPerDestination {
+      /** The status of the ingest audience members request. */
+      audienceMembersIngestionStatus?: IngestAudienceMembersStatus;
+      /** The status of the remove audience members request. */
+      audienceMembersRemovalStatus?: RemoveAudienceMembersStatus;
+      /** A destination within a DM API request. */
+      destination?: Destination;
+      /** An error info error containing the error reason and error counts related to the upload. */
+      errorInfo?: ErrorInfo;
+      /** The status of the ingest events request. */
+      eventsIngestionStatus?: IngestEventsStatus;
+      /** The request status of the destination. */
+      requestStatus?: string;
+      /** A warning info containing the warning reason and warning counts related to the upload. */
+      warningInfo?: WarningInfo;
+    }
+    interface RetrieveRequestStatusResponse {
+      /** A list of request statuses per destination. The order of the statuses matches the order of the destinations in the original request. */
+      requestStatusPerDestination?: RequestStatusPerDestination[];
+    }
+    interface TermsOfService {
+      /** Optional. The Customer Match terms of service: https://support.google.com/adspolicy/answer/6299717. This must be accepted when ingesting UserData or MobileData. This field is not required for Partner Match User list. */
+      customerMatchTermsOfServiceStatus?: string;
+    }
+    interface UserData {
+      /** Required. The identifiers for the user. It's possible to provide multiple instances of the same type of data (for example, multiple email addresses). To increase the likelihood of a match, provide as many identifiers as possible. At most 10 `userIdentifiers` can be provided in a single AudienceMember or Event. */
+      userIdentifiers?: UserIdentifier[];
+    }
+    interface UserIdentifier {
+      /** The known components of a user's address. Holds a grouping of identifiers that are matched all at once. */
+      address?: AddressInfo;
+      /** Hashed email address using SHA-256 hash function after normalization. */
+      emailAddress?: string;
+      /** Hashed phone number using SHA-256 hash function after normalization (E164 standard). */
+      phoneNumber?: string;
+    }
+    interface UserProperties {
+      /** Optional. Type of the customer associated with the event. */
+      customerType?: string;
+      /** Optional. The advertiser-assessed value of the customer. */
+      customerValueBucket?: string;
+    }
+    interface WarningCount {
+      /** The warning reason. */
+      reason?: string;
+      /** The count of records that have a warning. */
+      recordCount?: string;
+    }
+    interface WarningInfo {
+      /** A list of warnings and counts per warning reason. */
+      warningCounts?: WarningCount[];
+    }
+    interface AudienceMembersResource {
+      /** Uploads a list of AudienceMember resources to the provided Destination. */
+      ingest(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: IngestAudienceMembersRequest;
+      }): Request<IngestAudienceMembersResponse>;
+      ingest(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: IngestAudienceMembersRequest,
+      ): Request<IngestAudienceMembersResponse>;
+      /** Removes a list of AudienceMember resources from the provided Destination. */
+      remove(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: RemoveAudienceMembersRequest;
+      }): Request<RemoveAudienceMembersResponse>;
+      remove(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: RemoveAudienceMembersRequest,
+      ): Request<RemoveAudienceMembersResponse>;
+    }
+    interface EventsResource {
+      /** Uploads a list of Event resources from the provided Destination. */
+      ingest(request: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Request body */
+        resource: IngestEventsRequest;
+      }): Request<IngestEventsResponse>;
+      ingest(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: string;
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: string;
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+        },
+        body: IngestEventsRequest,
+      ): Request<IngestEventsResponse>;
+    }
+    interface RequestStatusResource {
+      /** Gets the status of a request given request id. */
+      retrieve(request?: {
+        /** V1 error format. */
+        '$.xgafv'?: string;
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: string;
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Required. Required. The request ID of the Data Manager API request. */
+        requestId?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+      }): Request<RetrieveRequestStatusResponse>;
+    }
+
+    const audienceMembers: AudienceMembersResource;
+
+    const events: EventsResource;
+
+    const requestStatus: RequestStatusResource;
+  }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxim_mazurok/gapi.client.datamanager-v1",
+  "version": "0.0.20251006",
+  "description": "TypeScript typings for Data Manager API v1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Maxim-Mazurok/google-api-typings-generator.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Maxim Mazurok",
+    "email": "maxim@mazurok.com",
+    "url": "https://maxim.mazurok.com"
+  },
+  "types": "index.d.ts",
+  "dependencies": {
+    "@types/gapi.client": "*",
+    "@types/gapi.client.discovery-v1": "*"
+  }
+}

package/readme.md

@@ -0,0 +1,93 @@
+# TypeScript typings for Data Manager API v1
+
+A unified ingestion API for data partners, agencies and advertisers to connect first-party data across Google advertising products.
+For detailed description please check [documentation](https://developers.google.com/data-manager).
+
+## Installing
+
+Install typings for Data Manager API:
+
+```
+npm install @types/gapi.client.datamanager-v1 --save-dev
+```
+
+## Usage
+
+You need to initialize Google API client in your code:
+
+```typescript
+gapi.load('client', () => {
+  // now we can use gapi.client
+  // ...
+});
+```
+
+Then load api client wrapper:
+
+```typescript
+gapi.client.load(
+  'https://datamanager.googleapis.com/$discovery/rest?version=v1',
+  () => {
+    // now we can use:
+    // gapi.client.datamanager
+  },
+);
+```
+
+```typescript
+// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
+gapi.client.load('datamanager', 'v1', () => {
+  // now we can use:
+  // gapi.client.datamanager
+});
+```
+
+Don't forget to authenticate your client before sending any request to resources:
+
+```typescript
+// declare client_id registered in Google Developers Console
+var client_id = '',
+  scope = [
+    // See, edit, create, import, or delete your customer data in Google Ads, Google Marketing Platform (Campaign Manager 360, Search Ads 360, Display & Video 360), and Google Analytics
+    'https://www.googleapis.com/auth/datamanager',
+  ],
+  immediate = true;
+// ...
+
+gapi.auth.authorize(
+  {client_id: client_id, scope: scope, immediate: immediate},
+  authResult => {
+    if (authResult && !authResult.error) {
+      /* handle successful authorization */
+    } else {
+      /* handle authorization error */
+    }
+  },
+);
+```
+
+After that you can use Data Manager API resources: <!-- TODO: make this work for multiple namespaces -->
+
+```typescript
+/*
+Uploads a list of AudienceMember resources to the provided Destination.
+*/
+await gapi.client.datamanager.audienceMembers.ingest({});
+
+/*
+Removes a list of AudienceMember resources from the provided Destination.
+*/
+await gapi.client.datamanager.audienceMembers.remove({});
+
+/*
+Uploads a list of Event resources from the provided Destination.
+*/
+await gapi.client.datamanager.events.ingest({});
+
+/*
+Gets the status of a request given request id.
+*/
+await gapi.client.datamanager.requestStatus.retrieve({});
+```
+
+For provenance information see [Provenance section on NPM](https://www.npmjs.com/package/@maxim_mazurok/gapi.client.datamanager-v1#Provenance:~:text=none-,Provenance,-Built%20and%20signed)