feat(searchads360): update the api

#### searchads360:v0 The following keys were added: - schemas.GoogleAdsSearchads360V0Resources__AdGroupAd.properties.effectiveLabels (Total Keys: 3) - schemas.GoogleAdsSearchads360V0Resources__AdGroupAdEffectiveLabel (Total Keys: 8) - schemas.GoogleAdsSearchads360V0Resources__AdGroupCriterion.properties.effectiveLabels (Total Keys: 3) - schemas.GoogleAdsSearchads360V0Resources__AdGroupCriterionEffectiveLabel (Total Keys: 8) - schemas.GoogleAdsSearchads360V0Resources__UserLocationView (Total Keys: 9) - schemas.GoogleAdsSearchads360V0Services__SearchAds360Row.properties.adGroupAdEffectiveLabel.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Services__SearchAds360Row.properties.adGroupCriterionEffectiveLabel.$ref (Total Keys: 1) - schemas.GoogleAdsSearchads360V0Services__SearchAds360Row.properties.userLocationView.$ref (Total Keys: 1)
googleapis · Nov 12, 2024 · 40e2bc7 · 40e2bc7
1 parent 1a93219
commit 40e2bc7
Show file tree

Hide file tree

Showing 2 changed files with 148 additions and 1 deletion.
diff --git a/docs/dyn/searchads360_v0.customers.searchAds360.html b/docs/dyn/searchads360_v0.customers.searchAds360.html
@@ -263,6 +263,9 @@ <h3>Method Details</h3>
           &quot;type&quot;: &quot;A String&quot;, # Output only. The type of ad.
         },
         &quot;creationTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this ad_group_ad was created. The datetime is in the customer&#x27;s time zone and in &quot;yyyy-MM-dd HH:mm:ss.ssssss&quot; format.
+        &quot;effectiveLabels&quot;: [ # Output only. The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad.
+          &quot;A String&quot;,
+        ],
         &quot;engineId&quot;: &quot;A String&quot;, # Output only. ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use &quot;ad_group_ad.ad.id&quot; instead.
         &quot;engineStatus&quot;: &quot;A String&quot;, # Output only. Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc.
         &quot;labels&quot;: [ # Output only. The resource names of labels attached to this ad group ad.
@@ -272,6 +275,12 @@ <h3>Method Details</h3>
         &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the ad. Ad group ad resource names have the form: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}`
         &quot;status&quot;: &quot;A String&quot;, # The status of the ad.
       },
+      &quot;adGroupAdEffectiveLabel&quot;: { # A relationship between an ad group ad and an effective label. An effective label is a label inherited or directly assigned to this ad group ad. # The ad group ad effective label referenced in the query.
+        &quot;adGroupAd&quot;: &quot;A String&quot;, # Immutable. The ad group ad to which the effective label is attached.
+        &quot;label&quot;: &quot;A String&quot;, # Immutable. The effective label assigned to the ad group ad.
+        &quot;ownerCustomerId&quot;: &quot;A String&quot;, # Output only. The ID of the Customer which owns the effective label.
+        &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the ad group ad effective label. Ad group ad effective label resource names have the form: `customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}`
+      },
       &quot;adGroupAdLabel&quot;: { # A relationship between an ad group ad and a label. # The ad group ad label referenced in the query.
         &quot;adGroupAd&quot;: &quot;A String&quot;, # Immutable. The ad group ad to which the label is attached.
         &quot;label&quot;: &quot;A String&quot;, # Immutable. The label assigned to the ad group ad.
@@ -310,6 +319,9 @@ <h3>Method Details</h3>
         &quot;creationTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this ad group criterion was created. The timestamp is in the customer&#x27;s time zone and in &quot;yyyy-MM-dd HH:mm:ss&quot; format.
         &quot;criterionId&quot;: &quot;A String&quot;, # Output only. The ID of the criterion.
         &quot;effectiveCpcBidMicros&quot;: &quot;A String&quot;, # Output only. The effective CPC (cost-per-click) bid.
+        &quot;effectiveLabels&quot;: [ # Output only. The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion.
+          &quot;A String&quot;,
+        ],
         &quot;engineId&quot;: &quot;A String&quot;, # Output only. ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use &quot;ad_group_criterion.criterion_id&quot; instead.
         &quot;engineStatus&quot;: &quot;A String&quot;, # Output only. The Engine Status for ad group criterion.
         &quot;finalUrlSuffix&quot;: &quot;A String&quot;, # URL template for appending params to final URL.
@@ -359,6 +371,12 @@ <h3>Method Details</h3>
           &quot;criterionName&quot;: &quot;A String&quot;, # The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
         },
       },
+      &quot;adGroupCriterionEffectiveLabel&quot;: { # A relationship between an ad group criterion and an effective label. An effective label is a label inherited or directly assigned to this ad group criterion. # The ad group criterion effective label referenced in the query.
+        &quot;adGroupCriterion&quot;: &quot;A String&quot;, # Immutable. The ad group criterion to which the effective label is attached.
+        &quot;label&quot;: &quot;A String&quot;, # Immutable. The effective label assigned to the ad group criterion.
+        &quot;ownerCustomerId&quot;: &quot;A String&quot;, # Output only. The ID of the Customer which owns the effective label.
+        &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the ad group criterion effective label. Ad group criterion effective label resource names have the form: `customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}`
+      },
       &quot;adGroupCriterionLabel&quot;: { # A relationship between an ad group criterion and a label. # The ad group criterion label referenced in the query.
         &quot;adGroupCriterion&quot;: &quot;A String&quot;, # Immutable. The ad group criterion to which the label is attached.
         &quot;label&quot;: &quot;A String&quot;, # Immutable. The label assigned to the ad group criterion.
@@ -1279,6 +1297,11 @@ <h3>Method Details</h3>
         &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}`
         &quot;type&quot;: &quot;A String&quot;, # Output only. Type of this list. This field is read-only.
       },
+      &quot;userLocationView&quot;: { # A user location view. User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country. # The user location view referenced in the query.
+        &quot;countryCriterionId&quot;: &quot;A String&quot;, # Output only. Criterion Id for the country.
+        &quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the user location view. UserLocation view resource names have the form: `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}`
+        &quot;targetingLocation&quot;: True or False, # Output only. Indicates whether location was targeted or not.
+      },
       &quot;visit&quot;: { # A visit. # The event level visit referenced in the query.
         &quot;adId&quot;: &quot;A String&quot;, # Output only. Ad ID. A value of 0 indicates that the ad is unattributed.
         &quot;assetFieldType&quot;: &quot;A String&quot;, # Output only. Asset field type of the visit event.
@@ -1413,6 +1436,9 @@ <h3>Method Details</h3>
         &quot;type&quot;: &quot;A String&quot;, # Output only. The type of ad.
       },
       &quot;creationTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this ad_group_ad was created. The datetime is in the customer&#x27;s time zone and in &quot;yyyy-MM-dd HH:mm:ss.ssssss&quot; format.
+      &quot;effectiveLabels&quot;: [ # Output only. The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad.
+        &quot;A String&quot;,
+      ],
       &quot;engineId&quot;: &quot;A String&quot;, # Output only. ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 360 entity, use &quot;ad_group_ad.ad.id&quot; instead.
       &quot;engineStatus&quot;: &quot;A String&quot;, # Output only. Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc.
       &quot;labels&quot;: [ # Output only. The resource names of labels attached to this ad group ad.
@@ -1422,6 +1448,12 @@ <h3>Method Details</h3>
       &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the ad. Ad group ad resource names have the form: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}`
       &quot;status&quot;: &quot;A String&quot;, # The status of the ad.
     },
+    &quot;adGroupAdEffectiveLabel&quot;: { # A relationship between an ad group ad and an effective label. An effective label is a label inherited or directly assigned to this ad group ad. # The ad group ad effective label referenced in the query.
+      &quot;adGroupAd&quot;: &quot;A String&quot;, # Immutable. The ad group ad to which the effective label is attached.
+      &quot;label&quot;: &quot;A String&quot;, # Immutable. The effective label assigned to the ad group ad.
+      &quot;ownerCustomerId&quot;: &quot;A String&quot;, # Output only. The ID of the Customer which owns the effective label.
+      &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the ad group ad effective label. Ad group ad effective label resource names have the form: `customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}`
+    },
     &quot;adGroupAdLabel&quot;: { # A relationship between an ad group ad and a label. # The ad group ad label referenced in the query.
       &quot;adGroupAd&quot;: &quot;A String&quot;, # Immutable. The ad group ad to which the label is attached.
       &quot;label&quot;: &quot;A String&quot;, # Immutable. The label assigned to the ad group ad.
@@ -1460,6 +1492,9 @@ <h3>Method Details</h3>
       &quot;creationTime&quot;: &quot;A String&quot;, # Output only. The timestamp when this ad group criterion was created. The timestamp is in the customer&#x27;s time zone and in &quot;yyyy-MM-dd HH:mm:ss&quot; format.
       &quot;criterionId&quot;: &quot;A String&quot;, # Output only. The ID of the criterion.
       &quot;effectiveCpcBidMicros&quot;: &quot;A String&quot;, # Output only. The effective CPC (cost-per-click) bid.
+      &quot;effectiveLabels&quot;: [ # Output only. The resource names of effective labels attached to this ad group criterion. An effective label is a label inherited or directly assigned to this ad group criterion.
+        &quot;A String&quot;,
+      ],
       &quot;engineId&quot;: &quot;A String&quot;, # Output only. ID of the ad group criterion in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use &quot;ad_group_criterion.criterion_id&quot; instead.
       &quot;engineStatus&quot;: &quot;A String&quot;, # Output only. The Engine Status for ad group criterion.
       &quot;finalUrlSuffix&quot;: &quot;A String&quot;, # URL template for appending params to final URL.
@@ -1509,6 +1544,12 @@ <h3>Method Details</h3>
         &quot;criterionName&quot;: &quot;A String&quot;, # The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.
       },
     },
+    &quot;adGroupCriterionEffectiveLabel&quot;: { # A relationship between an ad group criterion and an effective label. An effective label is a label inherited or directly assigned to this ad group criterion. # The ad group criterion effective label referenced in the query.
+      &quot;adGroupCriterion&quot;: &quot;A String&quot;, # Immutable. The ad group criterion to which the effective label is attached.
+      &quot;label&quot;: &quot;A String&quot;, # Immutable. The effective label assigned to the ad group criterion.
+      &quot;ownerCustomerId&quot;: &quot;A String&quot;, # Output only. The ID of the Customer which owns the effective label.
+      &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the ad group criterion effective label. Ad group criterion effective label resource names have the form: `customers/{customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}`
+    },
     &quot;adGroupCriterionLabel&quot;: { # A relationship between an ad group criterion and a label. # The ad group criterion label referenced in the query.
       &quot;adGroupCriterion&quot;: &quot;A String&quot;, # Immutable. The ad group criterion to which the label is attached.
       &quot;label&quot;: &quot;A String&quot;, # Immutable. The label assigned to the ad group criterion.
@@ -2429,6 +2470,11 @@ <h3>Method Details</h3>
       &quot;resourceName&quot;: &quot;A String&quot;, # Immutable. The resource name of the user list. User list resource names have the form: `customers/{customer_id}/userLists/{user_list_id}`
       &quot;type&quot;: &quot;A String&quot;, # Output only. Type of this list. This field is read-only.
     },
+    &quot;userLocationView&quot;: { # A user location view. User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country. # The user location view referenced in the query.
+      &quot;countryCriterionId&quot;: &quot;A String&quot;, # Output only. Criterion Id for the country.
+      &quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the user location view. UserLocation view resource names have the form: `customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}`
+      &quot;targetingLocation&quot;: True or False, # Output only. Indicates whether location was targeted or not.
+    },
     &quot;visit&quot;: { # A visit. # The event level visit referenced in the query.
       &quot;adId&quot;: &quot;A String&quot;, # Output only. Ad ID. A value of 0 indicates that the ad is unattributed.
       &quot;assetFieldType&quot;: &quot;A String&quot;, # Output only. Asset field type of the visit event.