feat(dfareporting): update the api

#### dfareporting:v4

The following keys were added:
- schemas.Conversion.properties.sessionAttributesEncoded (Total Keys: 2)

Author: yoshi-automation

docs/dyn/dfareporting_v4.conversions.html

@@ -97,7 +97,7 @@ <h3>Method Details</h3>
   &quot;conversions&quot;: [ # The set of conversions to insert.
     { # A Conversion represents when a user successfully performs a desired action after seeing an ad.
       &quot;adUserDataConsent&quot;: &quot;A String&quot;, # This represents consent for ad user data.
-      &quot;cartData&quot;: { # Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. # The cart data associated with this conversion.
+      &quot;cartData&quot;: { #  *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
         &quot;items&quot;: [ # Data of the items purchased.
           { # Contains data of the items purchased.
             &quot;itemId&quot;: &quot;A String&quot;, # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
@@ -111,7 +111,7 @@ <h3>Method Details</h3>
       },
       &quot;childDirectedTreatment&quot;: True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
       &quot;customVariables&quot;: [ # Custom floodlight variables.
-        { # A custom floodlight variable. This field may only be used when calling batchinsert; it is not supported by batchupdate.
+        { # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
           &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#customFloodlightVariable&quot;.
           &quot;type&quot;: &quot;A String&quot;, # The type of custom floodlight variable to supply a value for. These map to the &quot;u[1-100]=&quot; in the tags.
           &quot;value&quot;: &quot;A String&quot;, # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
@@ -133,6 +133,7 @@ <h3>Method Details</h3>
       &quot;nonPersonalizedAd&quot;: True or False, # Whether the conversion was for a non personalized ad.
       &quot;ordinal&quot;: &quot;A String&quot;, # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
       &quot;quantity&quot;: &quot;A String&quot;, # The quantity of the conversion. This is a required field.
+      &quot;sessionAttributesEncoded&quot;: &quot;A String&quot;, # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
       &quot;timestampMicros&quot;: &quot;A String&quot;, # The timestamp of conversion, in Unix epoch micros. This is a required field.
       &quot;treatmentForUnderage&quot;: True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union&#x27;s General Data Protection Regulation (GDPR).
       &quot;userIdentifiers&quot;: [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.
@@ -177,7 +178,7 @@ <h3>Method Details</h3>
     { # The original conversion that was inserted or updated and whether there were any errors.
       &quot;conversion&quot;: { # A Conversion represents when a user successfully performs a desired action after seeing an ad. # The original conversion that was inserted or updated.
         &quot;adUserDataConsent&quot;: &quot;A String&quot;, # This represents consent for ad user data.
-        &quot;cartData&quot;: { # Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. # The cart data associated with this conversion.
+        &quot;cartData&quot;: { #  *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
           &quot;items&quot;: [ # Data of the items purchased.
             { # Contains data of the items purchased.
               &quot;itemId&quot;: &quot;A String&quot;, # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
@@ -191,7 +192,7 @@ <h3>Method Details</h3>
         },
         &quot;childDirectedTreatment&quot;: True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
         &quot;customVariables&quot;: [ # Custom floodlight variables.
-          { # A custom floodlight variable. This field may only be used when calling batchinsert; it is not supported by batchupdate.
+          { # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
             &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#customFloodlightVariable&quot;.
             &quot;type&quot;: &quot;A String&quot;, # The type of custom floodlight variable to supply a value for. These map to the &quot;u[1-100]=&quot; in the tags.
             &quot;value&quot;: &quot;A String&quot;, # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
@@ -213,6 +214,7 @@ <h3>Method Details</h3>
         &quot;nonPersonalizedAd&quot;: True or False, # Whether the conversion was for a non personalized ad.
         &quot;ordinal&quot;: &quot;A String&quot;, # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
         &quot;quantity&quot;: &quot;A String&quot;, # The quantity of the conversion. This is a required field.
+        &quot;sessionAttributesEncoded&quot;: &quot;A String&quot;, # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
         &quot;timestampMicros&quot;: &quot;A String&quot;, # The timestamp of conversion, in Unix epoch micros. This is a required field.
         &quot;treatmentForUnderage&quot;: True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union&#x27;s General Data Protection Regulation (GDPR).
         &quot;userIdentifiers&quot;: [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.
@@ -258,7 +260,7 @@ <h3>Method Details</h3>
   &quot;conversions&quot;: [ # The set of conversions to update.
     { # A Conversion represents when a user successfully performs a desired action after seeing an ad.
       &quot;adUserDataConsent&quot;: &quot;A String&quot;, # This represents consent for ad user data.
-      &quot;cartData&quot;: { # Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. # The cart data associated with this conversion.
+      &quot;cartData&quot;: { #  *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
         &quot;items&quot;: [ # Data of the items purchased.
           { # Contains data of the items purchased.
             &quot;itemId&quot;: &quot;A String&quot;, # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
@@ -272,7 +274,7 @@ <h3>Method Details</h3>
       },
       &quot;childDirectedTreatment&quot;: True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
       &quot;customVariables&quot;: [ # Custom floodlight variables.
-        { # A custom floodlight variable. This field may only be used when calling batchinsert; it is not supported by batchupdate.
+        { # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
           &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#customFloodlightVariable&quot;.
           &quot;type&quot;: &quot;A String&quot;, # The type of custom floodlight variable to supply a value for. These map to the &quot;u[1-100]=&quot; in the tags.
           &quot;value&quot;: &quot;A String&quot;, # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
@@ -294,6 +296,7 @@ <h3>Method Details</h3>
       &quot;nonPersonalizedAd&quot;: True or False, # Whether the conversion was for a non personalized ad.
       &quot;ordinal&quot;: &quot;A String&quot;, # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
       &quot;quantity&quot;: &quot;A String&quot;, # The quantity of the conversion. This is a required field.
+      &quot;sessionAttributesEncoded&quot;: &quot;A String&quot;, # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
       &quot;timestampMicros&quot;: &quot;A String&quot;, # The timestamp of conversion, in Unix epoch micros. This is a required field.
       &quot;treatmentForUnderage&quot;: True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union&#x27;s General Data Protection Regulation (GDPR).
       &quot;userIdentifiers&quot;: [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.
@@ -338,7 +341,7 @@ <h3>Method Details</h3>
     { # The original conversion that was inserted or updated and whether there were any errors.
       &quot;conversion&quot;: { # A Conversion represents when a user successfully performs a desired action after seeing an ad. # The original conversion that was inserted or updated.
         &quot;adUserDataConsent&quot;: &quot;A String&quot;, # This represents consent for ad user data.
-        &quot;cartData&quot;: { # Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. # The cart data associated with this conversion.
+        &quot;cartData&quot;: { #  *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
           &quot;items&quot;: [ # Data of the items purchased.
             { # Contains data of the items purchased.
               &quot;itemId&quot;: &quot;A String&quot;, # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
@@ -352,7 +355,7 @@ <h3>Method Details</h3>
         },
         &quot;childDirectedTreatment&quot;: True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
         &quot;customVariables&quot;: [ # Custom floodlight variables.
-          { # A custom floodlight variable. This field may only be used when calling batchinsert; it is not supported by batchupdate.
+          { # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
             &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;dfareporting#customFloodlightVariable&quot;.
             &quot;type&quot;: &quot;A String&quot;, # The type of custom floodlight variable to supply a value for. These map to the &quot;u[1-100]=&quot; in the tags.
             &quot;value&quot;: &quot;A String&quot;, # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
@@ -374,6 +377,7 @@ <h3>Method Details</h3>
         &quot;nonPersonalizedAd&quot;: True or False, # Whether the conversion was for a non personalized ad.
         &quot;ordinal&quot;: &quot;A String&quot;, # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
         &quot;quantity&quot;: &quot;A String&quot;, # The quantity of the conversion. This is a required field.
+        &quot;sessionAttributesEncoded&quot;: &quot;A String&quot;, # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
         &quot;timestampMicros&quot;: &quot;A String&quot;, # The timestamp of conversion, in Unix epoch micros. This is a required field.
         &quot;treatmentForUnderage&quot;: True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union&#x27;s General Data Protection Regulation (GDPR).
         &quot;userIdentifiers&quot;: [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.

googleapiclient/discovery_cache/documents/dfareporting.v4.json

@@ -10152,7 +10152,7 @@
 }
 }
 },
-"revision": "20250218",
+"revision": "20250602",
 "rootUrl": "https://dfareporting.googleapis.com/",
 "schemas": {
 "Account": {
@@ -11749,7 +11749,7 @@
 "type": "object"
 },
 "CartData": {
-"description": "Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate.",
+"description": " *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788)",
 "id": "CartData",
 "properties": {
 "items": {
@@ -12264,6 +12264,11 @@
 "format": "int64",
 "type": "string"
 },
+"sessionAttributesEncoded": {
+"description": "Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.",
+"format": "byte",
+"type": "string"
+},
 "timestampMicros": {
 "description": "The timestamp of conversion, in Unix epoch micros. This is a required field.",
 "format": "int64",
@@ -14422,7 +14427,7 @@
 "type": "object"
 },
 "CustomFloodlightVariable": {
-"description": "A custom floodlight variable. This field may only be used when calling batchinsert; it is not supported by batchupdate.",
+"description": "A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.",
 "id": "CustomFloodlightVariable",
 "properties": {
 "kind": {