@google-shopping/reports 0.6.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,28 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.8.0](https://github.com/googleapis/google-cloud-node/compare/reports-v0.7.0...reports-v0.8.0) (2025-03-18)
4
+
5
+
6
+ ### ⚠ BREAKING CHANGES
7
+
8
+ * upgrade to Node 18 ([#6096](https://github.com/googleapis/google-cloud-node/issues/6096))
9
+
10
+ ### Features
11
+
12
+ * [Many APIs] add request/response debug logging to gapics ([388b4e2](https://github.com/googleapis/google-cloud-node/commit/388b4e20329b7f6fc0dd061dddff573c45104213))
13
+
14
+
15
+ ### Miscellaneous Chores
16
+
17
+ * Upgrade to Node 18 ([#6096](https://github.com/googleapis/google-cloud-node/issues/6096)) ([eadae64](https://github.com/googleapis/google-cloud-node/commit/eadae64d54e07aa2c65097ea52e65008d4e87436))
18
+
19
+ ## [0.7.0](https://github.com/googleapis/google-cloud-node/compare/reports-v0.6.0...reports-v0.7.0) (2024-05-23)
20
+
21
+
22
+ ### Features
23
+
24
+ * [merchantapi] add `non_product_performance_view` table to Reports sub-API ([#5372](https://github.com/googleapis/google-cloud-node/issues/5372)) ([9e5778c](https://github.com/googleapis/google-cloud-node/commit/9e5778cf6bd2fae5141150ed00bdd1ed44643ca4))
25
+
3
26
  ## [0.6.0](https://github.com/googleapis/google-cloud-node/compare/reports-v0.5.0...reports-v0.6.0) (2024-05-21)
4
27
 
5
28
 
@@ -1,4 +1,4 @@
1
- // Copyright 2024 Google LLC
1
+ // Copyright 2025 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -89,6 +89,9 @@ message ReportRow {
89
89
  // Fields available for query in `product_performance_view` table.
90
90
  ProductPerformanceView product_performance_view = 1;
91
91
 
92
+ // Fields available for query in `non_product_performance_view` table.
93
+ NonProductPerformanceView non_product_performance_view = 7;
94
+
92
95
  // Fields available for query in `product_view` table.
93
96
  ProductView product_view = 2;
94
97
 
@@ -352,7 +355,7 @@ message ProductView {
352
355
  //
353
356
  // Here's an example of how the aggregated status is computed:
354
357
  //
355
- // Free listings | Shopping Ads | Status
358
+ // Free listings | Shopping ads | Status
356
359
  // --------------|--------------|------------------------------
357
360
  // Approved | Approved | ELIGIBLE
358
361
  // Approved | Pending | ELIGIBLE
@@ -480,7 +483,7 @@ message ProductView {
480
483
 
481
484
  // Normalized [shipping
482
485
  // label](https://support.google.com/merchants/answer/6324504) specified in
483
- // the feed.
486
+ // the data source.
484
487
  optional string shipping_label = 20;
485
488
 
486
489
  // List of Global Trade Item Numbers (GTINs) of the product.
@@ -607,6 +610,27 @@ message PriceCompetitivenessProductView {
607
610
  // Values are only set for fields requested explicitly in the request's search
608
611
  // query.
609
612
  message PriceInsightsProductView {
613
+ // Predicted effectiveness bucket.
614
+ //
615
+ // Effectiveness indicates which products would benefit most from price
616
+ // changes. This rating takes into consideration the performance boost
617
+ // predicted by adjusting the sale price and the difference between your
618
+ // current price and the suggested price. Price suggestions with `HIGH`
619
+ // effectiveness are predicted to drive the largest increase in performance.
620
+ enum Effectiveness {
621
+ // Effectiveness is unknown.
622
+ EFFECTIVENESS_UNSPECIFIED = 0;
623
+
624
+ // Effectiveness is low.
625
+ LOW = 1;
626
+
627
+ // Effectiveness is medium.
628
+ MEDIUM = 2;
629
+
630
+ // Effectiveness is high.
631
+ HIGH = 3;
632
+ }
633
+
610
634
  // REST ID of the product, in the form of
611
635
  // `channel~languageCode~feedLabel~offerId`. Can be used to join data with the
612
636
  // `product_view` table.
@@ -683,6 +707,9 @@ message PriceInsightsProductView {
683
707
  // suggested price compared to current active price. For example, 0.05 is a 5%
684
708
  // predicted increase in conversions).
685
709
  optional double predicted_conversions_change_fraction = 19;
710
+
711
+ // The predicted effectiveness of applying the price suggestion, bucketed.
712
+ Effectiveness effectiveness = 22;
686
713
  }
687
714
 
688
715
  // Fields available for query in `best_sellers_product_cluster_view` table.
@@ -778,16 +805,16 @@ message BestSellersProductClusterView {
778
805
  // GTINs of example variants of the product cluster.
779
806
  repeated string variant_gtins = 13;
780
807
 
781
- // Whether the product cluster is `IN_STOCK` in your product feed in at least
782
- // one of the countries, `OUT_OF_STOCK` in your product feed in all countries,
783
- // or `NOT_IN_INVENTORY` at all.
808
+ // Whether the product cluster is `IN_STOCK` in your product data source in at
809
+ // least one of the countries, `OUT_OF_STOCK` in your product data source in
810
+ // all countries, or `NOT_IN_INVENTORY` at all.
784
811
  //
785
812
  // The field doesn't take the Best sellers report country filter into account.
786
813
  optional InventoryStatus inventory_status = 14;
787
814
 
788
815
  // Whether there is at least one product of the brand currently `IN_STOCK` in
789
- // your product feed in at least one of the countries, all products are
790
- // `OUT_OF_STOCK` in your product feed in all countries, or
816
+ // your product data source in at least one of the countries, all products are
817
+ // `OUT_OF_STOCK` in your product data source in all countries, or
791
818
  // `NOT_IN_INVENTORY`.
792
819
  //
793
820
  // The field doesn't take the Best sellers report country filter into account.
@@ -878,6 +905,42 @@ message BestSellersBrandView {
878
905
  relative_demand_change = 11;
879
906
  }
880
907
 
908
+ // Fields available for query in `non_product_performance_view` table.
909
+ //
910
+ // Performance data on images and online store links leading to your non-product
911
+ // pages. This includes performance metrics (for example, `clicks`)
912
+ // and dimensions according to which performance metrics are segmented (for
913
+ // example, `date`).
914
+ //
915
+ // Segment fields cannot be selected in queries without also selecting at least
916
+ // one metric field.
917
+ //
918
+ // Values are only set for fields requested explicitly in the request's search
919
+ // query.
920
+ message NonProductPerformanceView {
921
+ // Date in the merchant timezone to which metrics apply. Segment.
922
+ //
923
+ // Condition on `date` is required in the `WHERE` clause.
924
+ google.type.Date date = 1;
925
+
926
+ // First day of the week (Monday) of the metrics date in the merchant
927
+ // timezone. Segment.
928
+ google.type.Date week = 2;
929
+
930
+ // Number of clicks on images and online store links leading to your
931
+ // non-product pages. Metric.
932
+ optional int64 clicks = 3;
933
+
934
+ // Number of times images and online store links leading to your non-product
935
+ // pages were shown. Metric.
936
+ optional int64 impressions = 4;
937
+
938
+ // Click-through rate - the number of clicks (`clicks`) divided by the number
939
+ // of impressions (`impressions`) of images and online store links leading to
940
+ // your non-product pages. Metric.
941
+ optional double click_through_rate = 5;
942
+ }
943
+
881
944
  // Fields available for query in `competitive_visibility_competitor_view` table.
882
945
  //
883
946
  // [Competitive
@@ -1,4 +1,4 @@
1
- // Copyright 2024 Google LLC
1
+ // Copyright 2025 Google LLC
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.