google-api-python-client 2.196.0__py3-none-any.whl → 2.198.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/datamanager.v1.json

@@ -732,6 +732,28 @@
 }
 }
 },
+"adEvents": {
+"methods": {
+"ingest": {
+"description": "Uploads a list of AdEvent resources to Google Analytics. This feature is only available to accounts on an allowlist.",
+"flatPath": "v1/adEvents:ingest",
+"httpMethod": "POST",
+"id": "datamanager.adEvents.ingest",
+"parameterOrder": [],
+"parameters": {},
+"path": "v1/adEvents:ingest",
+"request": {
+"$ref": "IngestAdEventsRequest"
+},
+"response": {
+"$ref": "IngestAdEventsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/datamanager"
+]
+}
+}
+},
 "audienceMembers": {
 "methods": {
 "ingest": {
@@ -820,13 +842,336 @@
 }
 }
 },
-"revision": "20260420",
+"revision": "20260605",
 "rootUrl": "https://datamanager.googleapis.com/",
 "schemas": {
+"AdEvent": {
+"description": "An ad event.",
+"id": "AdEvent",
+"properties": {
+"adFormat": {
+"description": "Enum value for ad format.",
+"enum": [
+"AD_FORMAT_UNSPECIFIED",
+"AD_FORMAT_AR",
+"AD_FORMAT_AUDIO",
+"AD_FORMAT_BANNER",
+"AD_FORMAT_BUMPER",
+"AD_FORMAT_CAROUSEL",
+"AD_FORMAT_COLLECTION",
+"AD_FORMAT_IMAGE",
+"AD_FORMAT_INTERACTIVE",
+"AD_FORMAT_INTERSTITIAL",
+"AD_FORMAT_IN_FEED",
+"AD_FORMAT_IN_STREAM",
+"AD_FORMAT_IN_STREAM_SKIPPABLE",
+"AD_FORMAT_IN_STREAM_NON_SKIPPABLE",
+"AD_FORMAT_NATIVE",
+"AD_FORMAT_SHORTS",
+"AD_FORMAT_STORY",
+"AD_FORMAT_SPONSORED",
+"AD_FORMAT_VIDEO"
+],
+"enumDescriptions": [
+"Unspecified ad format.",
+"AR ad.",
+"Audio ad.",
+"Banner ad.",
+"Bumper ad.",
+"Carousel ad.",
+"Collection ad.",
+"Image ad.",
+"Interactive ad.",
+"Interstitial ad.",
+"In-feed ad.",
+"In-stream ad.",
+"In-stream skippable ad.",
+"In-stream non-skippable ad.",
+"Native ad.",
+"Shorts ad.",
+"Story ad.",
+"Sponsored ad.",
+"Video ad."
+],
+"type": "string"
+},
+"adFormatString": {
+"description": "String value for ad format.",
+"type": "string"
+},
+"adGroupId": {
+"description": "Optional. The ID of the associated ad group.",
+"type": "string"
+},
+"adHeight": {
+"description": "Optional. The height of the ad in pixels.",
+"format": "int32",
+"type": "integer"
+},
+"adId": {
+"description": "Optional. The ID of the associated ad within the group.",
+"type": "string"
+},
+"adPlacement": {
+"description": "Enum value for ad placement.",
+"enum": [
+"AD_PLACEMENT_UNSPECIFIED",
+"AD_PLACEMENT_DISCOVER",
+"AD_PLACEMENT_FEED",
+"AD_PLACEMENT_FOOTER",
+"AD_PLACEMENT_HEADER",
+"AD_PLACEMENT_HOME",
+"AD_PLACEMENT_IN_CONTENT",
+"AD_PLACEMENT_PROMOTED",
+"AD_PLACEMENT_SEARCH",
+"AD_PLACEMENT_STORY"
+],
+"enumDescriptions": [
+"Unspecified ad placement.",
+"Discover placement.",
+"Feed placement.",
+"Footer placement.",
+"Header placement.",
+"Home placement.",
+"In-content placement.",
+"Promoted placement.",
+"Search placement.",
+"Story placement."
+],
+"type": "string"
+},
+"adPlacementString": {
+"description": "String value for ad placement.",
+"type": "string"
+},
+"adType": {
+"description": "Enum value for ad type.",
+"enum": [
+"AD_TYPE_UNSPECIFIED",
+"AD_TYPE_DISPLAY",
+"AD_TYPE_TEXT",
+"AD_TYPE_IMAGE",
+"AD_TYPE_RICH_MEDIA",
+"AD_TYPE_HTML",
+"AD_TYPE_AUDIO",
+"AD_TYPE_VIDEO"
+],
+"enumDescriptions": [
+"Unspecified ad type.",
+"Display ad.",
+"Text ad.",
+"Image ad.",
+"Rich media ad.",
+"HTML ad.",
+"Audio ad.",
+"Video ad."
+],
+"type": "string"
+},
+"adTypeString": {
+"description": "String value for ad type.",
+"type": "string"
+},
+"adWidth": {
+"description": "Optional. The width of the ad in pixels.",
+"format": "int32",
+"type": "integer"
+},
+"advertiserId": {
+"description": "Required. The ID of the advertiser for the ad event. This must match the ID sent in the linking flow.",
+"type": "string"
+},
+"attributionHint": {
+"description": "Optional. The partner-assumed attribution status for this ad event. This acts only as a signal for how the partner assumed attribution played out, and does not force an end result in final reports.",
+"enum": [
+"ATTRIBUTION_HINT_UNSPECIFIED",
+"ATTRIBUTION_HINT_CONVERTED",
+"ATTRIBUTION_HINT_NOT_CONVERTED"
+],
+"enumDescriptions": [
+"Unknown attribution status.",
+"Converted status.",
+"Not converted status."
+],
+"type": "string"
+},
+"campaignId": {
+"description": "Required. The ID of the associated campaign.",
+"type": "string"
+},
+"campaignName": {
+"description": "Required. The name of the associated campaign.",
+"type": "string"
+},
+"deviceInfo": {
+"$ref": "DeviceInfo",
+"description": "Optional. Information gathered about the device being used when the ad event happened."
+},
+"eventId": {
+"description": "Optional. An ID created and managed by the caller that uniquely identifies this event. Required if you want to deduplicate ad events that are included in multiple requests. Otherwise, this field is optional.",
+"type": "string"
+},
+"eventSubtype": {
+"description": "Enum value for event subtype.",
+"enum": [
+"EVENT_SUBTYPE_UNSPECIFIED",
+"EVENT_SUBTYPE_IMPRESSION",
+"EVENT_SUBTYPE_ENGAGED_VIEW",
+"EVENT_SUBTYPE_ONSITE_CLICK",
+"EVENT_SUBTYPE_OUTBOUND_CLICK"
+],
+"enumDescriptions": [
+"Unspecified event subtype.",
+"Impression event.",
+"Engaged view event.",
+"Onsite click event.",
+"Outbound click event."
+],
+"type": "string"
+},
+"eventSubtypeString": {
+"description": "String value for event subtype.",
+"type": "string"
+},
+"eventType": {
+"description": "Required. The type of the event.",
+"enum": [
+"EVENT_TYPE_UNSPECIFIED",
+"EVENT_TYPE_VIEW",
+"EVENT_TYPE_CLICK"
+],
+"enumDescriptions": [
+"Unspecified event type.",
+"View event.",
+"Click event."
+],
+"type": "string"
+},
+"measurementAllowed": {
+"description": "Optional. Represents if the row is allowed to be used for measurement purposes, as governed by applicable privacy laws within regional jurisdiction.",
+"type": "boolean"
+},
+"medium": {
+"description": "Required. The medium of the ad, akin to the Google Analytics medium.",
+"type": "string"
+},
+"mobileDeviceId": {
+"description": "Optional. The device ID of the device that the ad was served to.",
+"type": "string"
+},
+"platform": {
+"description": "Enum value for platform.",
+"enum": [
+"PLATFORM_UNSPECIFIED",
+"PLATFORM_IOS",
+"PLATFORM_ANDROID",
+"PLATFORM_WEB"
+],
+"enumDescriptions": [
+"Unspecified platform.",
+"iOS platform.",
+"Android platform.",
+"Web platform."
+],
+"type": "string"
+},
+"platformString": {
+"description": "String value for platform.",
+"type": "string"
+},
+"platformType": {
+"description": "Enum value for platform type.",
+"enum": [
+"PLATFORM_TYPE_UNSPECIFIED",
+"PLATFORM_TYPE_MOBILE",
+"PLATFORM_TYPE_DESKTOP",
+"PLATFORM_TYPE_CTV",
+"PLATFORM_TYPE_PHONE",
+"PLATFORM_TYPE_TABLET"
+],
+"enumDescriptions": [
+"Unspecified platform type.",
+"Mobile platform.",
+"Desktop platform.",
+"CTV platform.",
+"Phone platform.",
+"Tablet platform."
+],
+"type": "string"
+},
+"platformTypeString": {
+"description": "String value for platform type.",
+"type": "string"
+},
+"regionCode": {
+"description": "Required. The ISO 3166-2 country plus subdivision.",
+"type": "string"
+},
+"source": {
+"description": "Required. The platform source of the ad, akin to the Google Analytics source.",
+"type": "string"
+},
+"targetingType": {
+"description": "Enum value for targeting type.",
+"enum": [
+"TARGETING_TYPE_UNSPECIFIED",
+"TARGETING_TYPE_AUDIENCE",
+"TARGETING_TYPE_CONTEXTUAL",
+"TARGETING_TYPE_DEMOGRAPHIC",
+"TARGETING_TYPE_DEVICE",
+"TARGETING_TYPE_GEO",
+"TARGETING_TYPE_INTEREST",
+"TARGETING_TYPE_PURCHASE_INTENT",
+"TARGETING_TYPE_REMARKETING"
+],
+"enumDescriptions": [
+"Unspecified targeting type.",
+"Audience targeting.",
+"Contextual targeting.",
+"Demographic targeting.",
+"Device targeting.",
+"Geo targeting.",
+"Interest targeting.",
+"Purchase intent targeting.",
+"Remarketing targeting."
+],
+"type": "string"
+},
+"targetingTypeString": {
+"description": "String value for targeting type.",
+"type": "string"
+},
+"timestamp": {
+"description": "Required. The time the event occurred.",
+"format": "google-datetime",
+"type": "string"
+},
+"userData": {
+"$ref": "UserData",
+"description": "Optional. Multiple pieces of user-provided data, representing the user the event is associated with. It is possible to provide multiple instances of the same type of data (e.g. email address). The more data provided, the more likely a match will be found."
+},
+"viewabilityInfo": {
+"$ref": "ViewabilityInfo",
+"description": "Required. Details of the viewability of the ad served."
+}
+},
+"type": "object"
+},
 "AdIdentifiers": {
 "description": "Identifiers and other information used to match the conversion event with other online activity (such as ad clicks).",
 "id": "AdIdentifiers",
 "properties": {
+"dclid": {
+"description": "Optional. The display click ID associated with this event.",
+"type": "string"
+},
+"encryptedUserIds": {
+"description": "Optional. Any number of encrypted user IDs.",
+"items": {
+"$ref": "EncryptedUserId"
+},
+"type": "array"
+},
 "gbraid": {
 "description": "Optional. The click identifier for clicks associated with app events and originating from iOS devices starting with iOS14.",
 "type": "string"
@@ -835,10 +1180,22 @@
 "description": "Optional. The Google click ID (gclid) associated with this event.",
 "type": "string"
 },
+"impressionId": {
+"description": "Optional. The impression ID associated with this event.",
+"type": "string"
+},
 "landingPageDeviceInfo": {
 "$ref": "DeviceInfo",
 "description": "Optional. Information gathered about the device being used (if any) at the time of landing onto the advertiser\u2019s site after interacting with the ad."
 },
+"matchId": {
+"description": "Optional. The match ID field used to join this event with a previous event.",
+"type": "string"
+},
+"mobileDeviceId": {
+"description": "Optional. The mobile identifier for advertisers. This would be IDFA on iOS, AdID on Android, or other platforms\u2019 identifiers for advertisers.",
+"type": "string"
+},
 "sessionAttributes": {
 "description": "Optional. Session attributes for event attribution and modeling.",
 "type": "string"
@@ -877,6 +1234,10 @@
 "description": "The audience member to be operated on.",
 "id": "AudienceMember",
 "properties": {
+"compositeData": {
+"$ref": "CompositeData",
+"description": "Group of multiple identifier types."
+},
 "consent": {
 "$ref": "Consent",
 "description": "Optional. The consent setting for the user."
@@ -961,6 +1322,13 @@
 "description": "The cart data associated with the event.",
 "id": "CartData",
 "properties": {
+"couponCodes": {
+"description": "Optional. The list of coupon codes that were applied to the cart. Cart-level and item-level coupon codes are independent. If the event is for a Google Analytics destination, only provide a single coupon code. Google Analytics ignores additional coupon codes.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "items": {
 "description": "Optional. The list of items associated with the event.",
 "items": {
@@ -988,6 +1356,24 @@
 },
 "type": "object"
 },
+"CompositeData": {
+"description": "Composite data holding identifiers and associated data for a user. At least one of `user_data` or `ip_data` is required.",
+"id": "CompositeData",
+"properties": {
+"ipData": {
+"description": "Optional. IP address data representing customer interaction used to build the audience.",
+"items": {
+"$ref": "IpData"
+},
+"type": "array"
+},
+"userData": {
+"$ref": "UserData",
+"description": "Optional. User-provided data that identifies the user."
+}
+},
+"type": "object"
+},
 "Consent": {
 "description": "[Digital Markets Act (DMA)](//digital-markets-act.ec.europa.eu/index_en) consent settings for the user.",
 "id": "Consent",
@@ -1054,6 +1440,17 @@
 },
 "type": "object"
 },
+"CoordinatorKeyInfo": {
+"description": "Information about the coordinator key.",
+"id": "CoordinatorKeyInfo",
+"properties": {
+"keyId": {
+"description": "Required. The ID of the chosen coordinator key.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "CustomVariable": {
 "description": "Custom variable for ads conversions.",
 "id": "CustomVariable",
@@ -1076,6 +1473,36 @@
 },
 "type": "object"
 },
+"DataTypeCount": {
+"description": "The count for a specific data type.",
+"id": "DataTypeCount",
+"properties": {
+"count": {
+"description": "The count for this data type.",
+"format": "int64",
+"type": "string"
+},
+"type": {
+"description": "The type of data.",
+"enum": [
+"DATA_TYPE_UNSPECIFIED",
+"EMAIL",
+"PHONE_NUMBER",
+"ADDRESS",
+"IP_ADDRESS"
+],
+"enumDescriptions": [
+"The data type is unspecified.",
+"The data is an email address.",
+"The data is a phone number.",
+"The data is a physical address.",
+"The data is an IP address."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "Destination": {
 "description": "The Google product you're sending data to. For example, a Google Ads account.",
 "id": "Destination",
@@ -1107,10 +1534,52 @@
 "description": "Information about the device being used (if any) when the event happened.",
 "id": "DeviceInfo",
 "properties": {
+"brand": {
+"description": "Optional. The brand of the device.",
+"type": "string"
+},
+"browser": {
+"description": "Optional. The brand or type of the browser.",
+"type": "string"
+},
+"browserVersion": {
+"description": "Optional. The version of the browser.",
+"type": "string"
+},
+"category": {
+"description": "Optional. The category of device. For example, \u201cdesktop\u201d, \u201ctablet\u201d, \u201cmobile\u201d, \u201csmart TV\u201d.",
+"type": "string"
+},
 "ipAddress": {
 "description": "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.",
 "type": "string"
 },
+"languageCode": {
+"description": "Optional. The language the device uses in ISO 639-1 format.",
+"type": "string"
+},
+"model": {
+"description": "Optional. The model of the device.",
+"type": "string"
+},
+"operatingSystem": {
+"description": "Optional. The operating system or platform of the device.",
+"type": "string"
+},
+"operatingSystemVersion": {
+"description": "Optional. The version of the operating system or platform.",
+"type": "string"
+},
+"screenHeight": {
+"description": "Optional. The height of the screen in pixels.",
+"format": "int32",
+"type": "integer"
+},
+"screenWidth": {
+"description": "Optional. The width of the screen in pixels.",
+"format": "int32",
+"type": "integer"
+},
 "userAgent": {
 "description": "Optional. The user-agent string of the device for the given context.",
 "type": "string"
@@ -1124,6 +1593,58 @@
 "properties": {},
 "type": "object"
 },
+"EncryptedUserId": {
+"description": "A user identifier issued to be used for attribution. All fields are required if this is used.",
+"id": "EncryptedUserId",
+"properties": {
+"encryptedId": {
+"description": "Required. The alphanumeric encrypted id.",
+"type": "string"
+},
+"entityId": {
+"description": "Required. The encryption entity ID. This should match the encryption configuration for ad serving or Data Transfer.",
+"format": "int64",
+"type": "string"
+},
+"entityType": {
+"description": "Required. The encryption entity type. This should match the encryption configuration for ad serving or Data Transfer.",
+"enum": [
+"ENCRYPTION_ENTITY_TYPE_UNSPECIFIED",
+"CAMPAIGN_MANAGER_ACCOUNT",
+"CAMPAIGN_MANAGER_ADVERTISER",
+"DISPLAY_VIDEO_PARTNER",
+"DISPLAY_VIDEO_ADVERTISER",
+"GOOGLE_ADS_CUSTOMER",
+"GOOGLE_AD_MANAGER_NETWORK_CODE"
+],
+"enumDescriptions": [
+"Unspecified encryption entity type.",
+"Campaign Manager 360 account.",
+"Campaign Manager 360 advertiser.",
+"Display & Video 360 partner.",
+"Display & Video 360 advertiser.",
+"Google Ads customer.",
+"Google Ad Manager network code."
+],
+"type": "string"
+},
+"source": {
+"description": "Required. Describes whether the encrypted cookie was received from ad serving (the %m macro) or from Data Transfer.",
+"enum": [
+"ENCRYPTION_SOURCE_UNSPECIFIED",
+"AD_SERVING",
+"DATA_TRANSFER"
+],
+"enumDescriptions": [
+"Unspecified encryption source.",
+"Ad serving encryption source.",
+"Data transfer encryption source."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "EncryptionInfo": {
 "description": "Encryption information for the data being ingested.",
 "id": "EncryptionInfo",
@@ -1132,6 +1653,10 @@
 "$ref": "AwsWrappedKeyInfo",
 "description": "Amazon Web Services wrapped key information."
 },
+"coordinatorKeyInfo": {
+"$ref": "CoordinatorKeyInfo",
+"description": "Key information for the chosen coordinator key. This is not supported for the IngestEvents, IngestAudienceMembers, and RemoveAudienceMembers methods."
+},
 "gcpWrappedKeyInfo": {
 "$ref": "GcpWrappedKeyInfo",
 "description": "Google Cloud Platform wrapped key information."
@@ -1174,38 +1699,22 @@
 "PROCESSING_ERROR_REASON_AWS_AUTH_FAILED",
 "PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR",
 "PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER",
-"PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID"
-],
-"enumDeprecated": [
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-false,
-true
+"PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID",
+"PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND",
+"PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID",
+"PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID",
+"PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID",
+"PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS",
+"PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT",
+"PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND",
+"PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR",
+"PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID",
+"PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND",
+"PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK",
+"PROCESSING_ERROR_REASON_TOO_RECENT_CLICK",
+"PROCESSING_ERROR_REASON_INVALID_CLICK",
+"PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK",
+"PROCESSING_ERROR_REASON_CLICK_NOT_FOUND"
 ],
 "enumDescriptions": [
 "The processing error reason is unknown.",
@@ -1236,7 +1745,22 @@ true
 "The system failed to authenticate with AWS.",
 "Failed to decrypt the UserIdentifier data using the DEK.",
 "The user attempted to ingest events with an ad identifier that isn't from the operating account's ads.",
-"One-per-click conversion actions cannot be used with BRAIDs."
+"One-per-click conversion actions cannot be used with BRAIDs.",
+"The match ID can not be found.",
+"The user ID can not be found for the match ID.",
+"The user ID can not be found for the GCLID.",
+"The user ID can not be found for the DCLID.",
+"There are ad identifiers that are invalid.",
+"The mobile ID format is invalid.",
+"The original conversions can't be found.",
+"The event ID (dclid or impression ID) cannot be decoded.",
+"The user ID cannot be found for the given impression ID.",
+"The user ID cannot be found.",
+"The event timestamp on the event was earlier than the associated click.",
+"The click occurred too recently.",
+"The event can't be attributed to a click (GCLID). This may be because the click did not come from a Google Ads campaign, for example.",
+"The click from the event isn't associated with the `operating_account` of the destination.",
+"A corresponding click can't be found that matches the provided attributes."
 ],
 "type": "string"
 },
@@ -1277,6 +1801,10 @@ true
 },
 "type": "array"
 },
+"appInstanceId": {
+"description": "Optional. A unique identifier for the user instance of an app client for this GA4 app stream.",
+"type": "string"
+},
 "cartData": {
 "$ref": "CartData",
 "description": "Optional. Information about the transaction and items associated with the event."
@@ -1289,6 +1817,11 @@ true
 "$ref": "Consent",
 "description": "Optional. Information about whether the associated user has provided different types of consent."
 },
+"conversionCount": {
+"description": "Optional. The conversion quantity associated with the event, for counting-based conversions.",
+"format": "double",
+"type": "number"
+},
 "conversionValue": {
 "description": "Optional. The conversion value associated with the event, for value-based conversions.",
 "format": "double",
@@ -1316,6 +1849,10 @@ true
 "$ref": "DeviceInfo",
 "description": "Optional. Information gathered about the device being used (if any) when the event happened."
 },
+"eventLocation": {
+"$ref": "EventLocation",
+"description": "Optional. Information gathered about the location of the user when this event occurred."
+},
 "eventName": {
 "description": "Optional. The name of the event. Required for GA4 events.",
 "type": "string"
@@ -1328,6 +1865,7 @@ true
 "APP",
 "IN_STORE",
 "PHONE",
+"MESSAGE",
 "OTHER"
 ],
 "enumDescriptions": [
@@ -1336,6 +1874,7 @@ true
 "The event was generated from an app.",
 "The event was generated from an in-store transaction.",
 "The event was generated from a phone call.",
+"The event was generated from a message.",
 "The event was generated from other sources."
 ],
 "type": "string"
@@ -1357,8 +1896,12 @@ true
 "format": "google-datetime",
 "type": "string"
 },
+"thirdPartyUserData": {
+"$ref": "UserData",
+"description": "Optional. The same type of data provided in user_data, but explicitly flagged as being provided as owned by a third-party and not first-party advertiser data."
+},
 "transactionId": {
-"description": "Optional. The unique identifier for this event. Required for conversions using multiple data sources.",
+"description": "Optional. The unique identifier for this event. Required for events sent as an additional data source for tag conversions.",
 "type": "string"
 },
 "userData": {
@@ -1376,6 +1919,37 @@ true
 },
 "type": "object"
 },
+"EventLocation": {
+"description": "The location where the event occurred.",
+"id": "EventLocation",
+"properties": {
+"city": {
+"description": "Optional. The name of the city where the event occurred.",
+"type": "string"
+},
+"continentCode": {
+"description": "Optional. The continent code in UN M49 format where the event occurred.",
+"type": "string"
+},
+"regionCode": {
+"description": "Optional. The 2-letter CLDR region code of the user's address.",
+"type": "string"
+},
+"storeId": {
+"description": "Optional. Required for Store Sales. The identifier to represent a physical store where the event happened.",
+"type": "string"
+},
+"subcontinentCode": {
+"description": "Optional. The subcontinent code in UN M49 format where the event occurred.",
+"type": "string"
+},
+"subdivisionCode": {
+"description": "Optional. The ISO 3166-2 subdivision code where the event occurred.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "EventParameter": {
 "description": "Event parameter for GA4 events.",
 "id": "EventParameter",
@@ -1437,6 +2011,34 @@ true
 },
 "type": "object"
 },
+"IngestAdEventsRequest": {
+"description": "Request to upload ad events.",
+"id": "IngestAdEventsRequest",
+"properties": {
+"adEvents": {
+"description": "Required. Required (at least 1). A list of ad events.",
+"items": {
+"$ref": "AdEvent"
+},
+"type": "array"
+},
+"encryptionInfo": {
+"$ref": "EncryptionInfo",
+"description": "Optional. Information about encryption keys which are used to encrypt the data."
+},
+"validateOnly": {
+"description": "Optional. If true, the request is validated, but not executed.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
+"IngestAdEventsResponse": {
+"description": "Response from an ad event ingestion operation.",
+"id": "IngestAdEventsResponse",
+"properties": {},
+"type": "object"
+},
 "IngestAudienceMembersRequest": {
 "description": "Request to upload audience members to the provided destinations. Returns an IngestAudienceMembersResponse.",
 "id": "IngestAudienceMembersRequest",
@@ -1503,6 +2105,10 @@ true
 "description": "The status of the ingest audience members request.",
 "id": "IngestAudienceMembersStatus",
 "properties": {
+"compositeDataIngestionStatus": {
+"$ref": "IngestCompositeDataStatus",
+"description": "The status of the composite data ingestion to the destination."
+},
 "mobileDataIngestionStatus": {
 "$ref": "IngestMobileDataStatus",
 "description": "The status of the mobile data ingestion to the destination."
@@ -1526,6 +2132,55 @@ true
 },
 "type": "object"
 },
+"IngestCompositeDataStatus": {
+"description": "The status of the composite data ingestion to the destination containing stats related to the ingestion.",
+"id": "IngestCompositeDataStatus",
+"properties": {
+"dataTypeCounts": {
+"description": "The total count of data types sent in the upload request for the destination, broken down by data type. Includes all data types in the request, regardless of whether they were successfully ingested or not.",
+"items": {
+"$ref": "DataTypeCount"
+},
+"type": "array"
+},
+"recordCount": {
+"description": "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.",
+"format": "int64",
+"type": "string"
+},
+"uploadMatchRateRange": {
+"description": "The match rate range of the upload.",
+"enum": [
+"MATCH_RATE_RANGE_UNKNOWN",
+"MATCH_RATE_RANGE_NOT_ELIGIBLE",
+"MATCH_RATE_RANGE_LESS_THAN_20",
+"MATCH_RATE_RANGE_20_TO_30",
+"MATCH_RATE_RANGE_31_TO_40",
+"MATCH_RATE_RANGE_41_TO_50",
+"MATCH_RATE_RANGE_51_TO_60",
+"MATCH_RATE_RANGE_61_TO_70",
+"MATCH_RATE_RANGE_71_TO_80",
+"MATCH_RATE_RANGE_81_TO_90",
+"MATCH_RATE_RANGE_91_TO_100"
+],
+"enumDescriptions": [
+"The match rate range is unknown.",
+"The match rate range is not eligible.",
+"The match rate range is less than 20% (in the interval `[0, 20)`).",
+"The match rate range is between 20% and 30% (in the interval `[20, 31)`).",
+"The match rate range is between 31% and 40% (in the interval `[31, 41)`).",
+"The match rate range is between 41% and 50% (in the interval `[41, 51)`).",
+"The match rate range is between 51% and 60% (in the interval `[51, 61)`.",
+"The match rate range is between 61% and 70% (in the interval `[61, 71)`).",
+"The match rate range is between 71% and 80% (in the interval `[71, 81)`).",
+"The match rate range is between 81% and 90% (in the interval `[81, 91)`).",
+"The match rate range is between 91% and 100% (in the interval `[91, 100]`)."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "IngestEventsRequest": {
 "description": "Request to upload audience members to the provided destinations. Returns an IngestEventsResponse.",
 "id": "IngestEventsRequest",
@@ -1765,6 +2420,27 @@ true
 },
 "type": "object"
 },
+"IpData": {
+"description": "IP address information for a user. We recommend including observe_start_time and observe_end_time to help improve Customer Match match rates.",
+"id": "IpData",
+"properties": {
+"ipAddress": {
+"description": "Required. IP address captured at the time of customer interaction. Accepts standard string formats for both IPv4 and IPv6.",
+"type": "string"
+},
+"observeEndTime": {
+"description": "Optional. Last recorded interaction time from this IP address in a session.",
+"format": "google-datetime",
+"type": "string"
+},
+"observeStartTime": {
+"description": "Optional. First recorded interaction time from this IP address in a session.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Item": {
 "description": "Represents an item in the cart associated with the event.",
 "id": "Item",
@@ -1776,10 +2452,34 @@ true
 },
 "type": "array"
 },
+"conversionValue": {
+"description": "Optional. The conversion value associated with this item within the event, for cases where the conversion value is different for each item.",
+"format": "double",
+"type": "number"
+},
+"customVariables": {
+"description": "Optional. Additional key/value pair information to send to the conversion containers (conversion action or Floodlight activity), when tracking per-item conversions.",
+"items": {
+"$ref": "ItemCustomVariable"
+},
+"type": "array"
+},
 "itemId": {
 "description": "Optional. A unique identifier to reference the item.",
 "type": "string"
 },
+"merchantFeedLabel": {
+"description": "Optional. The feed label of the Merchant Center feed. If countries are still being used, the 2-letter country code in ISO-3166-1 alpha-2 can be used instead. For Store Sales events this will override the value set at the cart level. This field is ignored for other events.",
+"type": "string"
+},
+"merchantFeedLanguageCode": {
+"description": "Optional. The language code in ISO 639-1 associated with the Merchant Center feed where your items are uploaded.",
+"type": "string"
+},
+"merchantId": {
+"description": "Optional. The Merchant Center ID associated with the item. For Store Sales events this will override the value set at the cart level. This field is ignored for other events.",
+"type": "string"
+},
 "merchantProductId": {
 "description": "Optional. The product ID within the Merchant Center account.",
 "type": "string"
@@ -1797,6 +2497,28 @@ true
 },
 "type": "object"
 },
+"ItemCustomVariable": {
+"description": "Item-level custom variable for ads conversions.",
+"id": "ItemCustomVariable",
+"properties": {
+"destinationReferences": {
+"description": "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.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"value": {
+"description": "Optional. The value to store for the custom variable.",
+"type": "string"
+},
+"variable": {
+"description": "Optional. The name of the custom variable to set. If the variable is not found for the given destination, it will be ignored.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ItemParameter": {
 "description": "A bucket of any [event parameters related to an item](https://developers.google.com/analytics/devguides/collection/protocol/ga4/reference/events) to be included within the event that were not already specified using other structured fields.",
 "id": "ItemParameter",
@@ -2117,10 +2839,43 @@ true
 },
 "type": "object"
 },
+"PartnerCustomerAccount": {
+"description": "Represents a customer account in the partner's system.",
+"id": "PartnerCustomerAccount",
+"properties": {
+"accountId": {
+"description": "Required. The identifier of the customer account in the partner's ID space.",
+"type": "string"
+},
+"accountName": {
+"description": "Optional. The name of the account.",
+"type": "string"
+},
+"accountType": {
+"description": "Optional. The type of the account. Can be used to distinguish between advertiser accounts and business level accounts, for example.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "PartnerLink": {
 "description": "A partner link between an owning account and a partner account.",
 "id": "PartnerLink",
 "properties": {
+"featureSet": {
+"description": "Optional. Immutable. The set of features supported for the partner link. If not specified, the system behavior defaults to FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT.",
+"enum": [
+"FEATURE_SET_UNSPECIFIED",
+"FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT",
+"FEATURE_SET_AD_EVENT_MANAGEMENT"
+],
+"enumDescriptions": [
+"Unspecified feature set. If unspecified, the system behavior defaults to FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT.",
+"Indicates a link used for audience and event management.",
+"Indicates a link used for ad event management."
+],
+"type": "string"
+},
 "name": {
 "description": "Identifier. The name of the partner link. Format: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}",
 "type": "string"
@@ -2133,10 +2888,32 @@ true
 "$ref": "ProductAccount",
 "description": "Required. The partner account granted access by the owning account."
 },
+"partnerCustomerAccount": {
+"$ref": "PartnerCustomerAccount",
+"description": "Optional. The customer account in the partner system. This is required for partner links with the FEATURE_SET_AD_EVENT_MANAGEMENT feature set."
+},
 "partnerLinkId": {
 "description": "Output only. The partner link ID.",
 "readOnly": true,
 "type": "string"
+},
+"partnerLinkMetadata": {
+"$ref": "PartnerLinkMetadata",
+"description": "Optional. Metadata associated with the partner link. This is optional and only accepted for partner links with the FEATURE_SET_AD_EVENT_MANAGEMENT."
+}
+},
+"type": "object"
+},
+"PartnerLinkMetadata": {
+"description": "Represents metadata associated with a partner link.",
+"id": "PartnerLinkMetadata",
+"properties": {
+"implicitAccounts": {
+"description": "Optional. The list of implicit accounts.",
+"items": {
+"$ref": "PartnerCustomerAccount"
+},
+"type": "array"
 }
 },
 "type": "object"
@@ -2164,7 +2941,7 @@ true
 "type": "string"
 },
 "accountType": {
-"description": "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.",
+"description": "Required. 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.",
 "enum": [
 "ACCOUNT_TYPE_UNSPECIFIED",
 "GOOGLE_ADS",
@@ -2172,7 +2949,8 @@ true
 "DISPLAY_VIDEO_ADVERTISER",
 "DATA_PARTNER",
 "GOOGLE_ANALYTICS_PROPERTY",
-"GOOGLE_AD_MANAGER_AUDIENCE_LINK"
+"GOOGLE_AD_MANAGER_AUDIENCE_LINK",
+"FLOODLIGHT_CONFIG"
 ],
 "enumDescriptions": [
 "Unspecified product. Should never be used.",
@@ -2181,7 +2959,8 @@ true
 "Display & Video 360 advertiser.",
 "Data Partner.",
 "Google Analytics.",
-"Google Ad Manager audience link."
+"Google Ad Manager audience link.",
+"Floodlight configuration."
 ],
 "type": "string"
 },
@@ -2294,6 +3073,10 @@ true
 "description": "The status of the remove audience members request.",
 "id": "RemoveAudienceMembersStatus",
 "properties": {
+"compositeDataRemovalStatus": {
+"$ref": "RemoveCompositeDataStatus",
+"description": "The status of the composite data removal from the destination."
+},
 "mobileDataRemovalStatus": {
 "$ref": "RemoveMobileDataStatus",
 "description": "The status of the mobile data removal from the destination."
@@ -2317,6 +3100,25 @@ true
 },
 "type": "object"
 },
+"RemoveCompositeDataStatus": {
+"description": "The status of the composite data removal from the destination.",
+"id": "RemoveCompositeDataStatus",
+"properties": {
+"dataTypeCounts": {
+"description": "The total count of data types sent in the removal request, broken down by data type. Includes all data types in the request, regardless of whether they were successfully removed or not.",
+"items": {
+"$ref": "DataTypeCount"
+},
+"type": "array"
+},
+"recordCount": {
+"description": "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.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
 "RemoveMobileDataStatus": {
 "description": "The status of the mobile data removal from the destination.",
 "id": "RemoveMobileDataStatus",
@@ -2420,7 +3222,7 @@ true
 },
 "errorInfo": {
 "$ref": "ErrorInfo",
-"description": "An error info error containing the error reason and error counts related to the upload."
+"description": "An error info error containing the error reason and error counts related to the upload. Only populated if the `request_status` is `FAILED` or `PARTIAL_SUCCESS`. This field isn't populated while the request has `request_status` of `PROCESSING`."
 },
 "eventsIngestionStatus": {
 "$ref": "IngestEventsStatus",
@@ -2437,16 +3239,16 @@ true
 ],
 "enumDescriptions": [
 "The request status is unknown.",
-"The request succeeded.",
+"Processing succeeded for all records without any errors. However, there may be warnings in the `warning_info` field.",
 "The request is processing.",
-"The request failed.",
-"The request partially succeeded."
+"Processing failed for all records. Check the `error_info` field for error details, and check the `warning_info` field for warning details.",
+"Processing completed successfully without errors for some records, but failed with errors for other records. Check the `error_info` field for error details, and check the `warning_info` field for warning details."
 ],
 "type": "string"
 },
 "warningInfo": {
 "$ref": "WarningInfo",
-"description": "A warning info containing the warning reason and warning counts related to the upload."
+"description": "A warning info containing the warning reason and warning counts related to the upload. This field isn't populated while the request has `request_status` of `PROCESSING`."
 }
 },
 "type": "object"
@@ -2522,11 +3324,23 @@ true
 "readOnly": true,
 "type": "string"
 },
+"gmailMembersCount": {
+"description": "Output only. Estimated number of members in this user list on Gmail.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
 "searchNetworkMembersCount": {
 "description": "Output only. Estimated number of members in this user list in the google.com domain. These are the members available for targeting in Search campaigns.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
+},
+"youtubeMembersCount": {
+"description": "Output only. Estimated number of members in this user list on YouTube.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
 }
 },
 "type": "object"
@@ -3202,6 +4016,76 @@ true
 },
 "type": "object"
 },
+"ViewabilityInfo": {
+"description": "Details of the viewability of the ad served.",
+"id": "ViewabilityInfo",
+"properties": {
+"mediaDuration": {
+"description": "Optional. The duration of the ad media.",
+"format": "google-duration",
+"type": "string"
+},
+"mediaQuartile": {
+"description": "Optional. The amount of the media that was played as discrete quartiles.",
+"enum": [
+"MEDIA_QUARTILE_UNSPECIFIED",
+"MEDIA_QUARTILE_START",
+"MEDIA_QUARTILE_FIRST_QUARTILE",
+"MEDIA_QUARTILE_MIDPOINT",
+"MEDIA_QUARTILE_THIRD_QUARTILE",
+"MEDIA_QUARTILE_COMPLETE"
+],
+"enumDescriptions": [
+"Unspecified media quartile.",
+"Start.",
+"First quartile.",
+"Midpoint.",
+"Third quartile.",
+"Complete."
+],
+"type": "string"
+},
+"mediaSkippable": {
+"description": "Optional. Whether the ad media was skippable or not.",
+"type": "boolean"
+},
+"mediaVolumePercent": {
+"description": "Optional. The numerical percent (0-100) of the volume of the media playback.",
+"format": "int32",
+"type": "integer"
+},
+"playbackDuration": {
+"description": "Optional. The duration of playback of the ad media, regardless of whether it was viewable or not.",
+"format": "google-duration",
+"type": "string"
+},
+"viewType": {
+"description": "Required. The type of the event.",
+"enum": [
+"VIEW_TYPE_UNSPECIFIED",
+"VIEW_TYPE_MRC_VIEWED",
+"VIEW_TYPE_MRC_RENDERED"
+],
+"enumDescriptions": [
+"Unspecified view type.",
+"MRC viewed.",
+"MRC rendered."
+],
+"type": "string"
+},
+"viewableDuration": {
+"description": "Optional. The amount of time the ad was viewable for.",
+"format": "google-duration",
+"type": "string"
+},
+"viewablePercent": {
+"description": "Optional. The numerical percent (0-100) of the pixels that were viewable.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "WarningCount": {
 "description": "The warning count for a given warning reason.",
 "id": "WarningCount",
@@ -3228,7 +4112,7 @@ true
 "The WIP could not be used because it was rejected by its attestation condition.",
 "The WIP is formatted incorrectly or the WIP does not exist.",
 "The KEK cannot decrypt data because it is the wrong KEK, or it does not exist.",
-"Failed to decrypt th UserIdentifier data using the DEK.",
+"Failed to decrypt the UserIdentifier data using the DEK.",
 "Internal error.",
 "The system failed to authenticate with AWS."
 ],