Google Shopping Merchant Reports V1beta Client - Class BestSellersProductClusterView (0.7.3)

Version 0.7.3

• 0.8.2 (latest)
• 0.8.1
• 0.7.3
• 0.6.0
• 0.5.0
• 0.4.0
• 0.3.0
• 0.2.0
• 0.1.0

Beta

This library is covered by the Pre-GA Offerings Terms of the Terms of Service. Pre-GA libraries might have limited support, and changes to pre-GA libraries might not be compatible with other pre-GA versions. For more information, see the launch stage descriptions.

Reference documentation and code samples for the Google Shopping Merchant Reports V1beta Client class BestSellersProductClusterView.

Fields available for query in best_sellers_product_cluster_view table.

Best sellers report with top product clusters. A product cluster is a grouping for different offers and variants that represent the same product, for example, Google Pixel 7. Values are only set for fields requested explicitly in the request's search query.

Generated from protobuf message google.shopping.merchant.reports.v1beta.BestSellersProductClusterView

Namespace

Google \ Shopping \ Merchant \ Reports \ V1beta

Methods

__construct

Constructor.

Parameters
Name	Description
data	array Optional. Data for populating the Message object.
↳ report_date	Google\Type\Date Report date. The value of this field can only be one of the following: * The first day of the week (Monday) for weekly reports, * The first day of the month for monthly reports. Required in the SELECT clause. If a WHERE condition on report_date is not specified in the query, the latest available weekly or monthly report is returned.
↳ report_granularity	int Granularity of the report. The ranking can be done over a week or a month timeframe. Required in the SELECT clause. Condition on report_granularity is required in the WHERE clause.
↳ report_country_code	string Country where the ranking is calculated. Represented in the ISO 3166 format. Required in the SELECT clause. Condition on report_country_code is required in the WHERE clause.
↳ report_category_id	int|string Google product category ID to calculate the ranking for, represented in Google's product taxonomy. Required in the SELECT clause. If a WHERE condition on report_category_id is not specified in the query, rankings for all top-level categories are returned.
↳ title	string Title of the product cluster.
↳ brand	string Brand of the product cluster.
↳ category_l1	string Product category (1st level) of the product cluster, represented in Google's product taxonomy.
↳ category_l2	string Product category (2nd level) of the product cluster, represented in Google's product taxonomy.
↳ category_l3	string Product category (3rd level) of the product cluster, represented in Google's product taxonomy.
↳ category_l4	string Product category (4th level) of the product cluster, represented in Google's product taxonomy.
↳ category_l5	string Product category (5th level) of the product cluster, represented in Google's product taxonomy.
↳ variant_gtins	array GTINs of example variants of the product cluster.
↳ inventory_status	int Whether the product cluster is IN_STOCK in your product feed in at least one of the countries, OUT_OF_STOCK in your product feed in all countries, or NOT_IN_INVENTORY at all. The field doesn't take the Best sellers report country filter into account.
↳ brand_inventory_status	int Whether there is at least one product of the brand currently IN_STOCK in your product feed in at least one of the countries, all products are OUT_OF_STOCK in your product feed in all countries, or NOT_IN_INVENTORY. The field doesn't take the Best sellers report country filter into account.
↳ rank	int|string Popularity of the product cluster on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold.
↳ previous_rank	int|string Popularity rank in the previous week or month.
↳ relative_demand	int Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country.
↳ previous_relative_demand	int Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country in the previous week or month.
↳ relative_demand_change	int Change in the estimated demand. Whether it rose, sank or remained flat.

getReportDate

Report date. The value of this field can only be one of the following:

• The first day of the week (Monday) for weekly reports,
• The first day of the month for monthly reports.

Required in the SELECT clause. If a WHERE condition on report_date is not specified in the query, the latest available weekly or monthly report is returned.

Returns
Type	Description
Google\Type\Date|null

hasReportDate

clearReportDate

setReportDate

Report date. The value of this field can only be one of the following:

• The first day of the week (Monday) for weekly reports,
• The first day of the month for monthly reports.

Required in the SELECT clause. If a WHERE condition on report_date is not specified in the query, the latest available weekly or monthly report is returned.

Parameter
Name	Description
var	Google\Type\Date

Returns
Type	Description
$this

getReportGranularity

Granularity of the report. The ranking can be done over a week or a month timeframe.

Required in the SELECT clause. Condition on report_granularity is required in the WHERE clause.

Returns
Type	Description
int

hasReportGranularity

clearReportGranularity

setReportGranularity

Granularity of the report. The ranking can be done over a week or a month timeframe.

Required in the SELECT clause. Condition on report_granularity is required in the WHERE clause.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getReportCountryCode

Country where the ranking is calculated. Represented in the ISO 3166 format.

Required in the SELECT clause. Condition on report_country_code is required in the WHERE clause.

Returns
Type	Description
string

hasReportCountryCode

clearReportCountryCode

setReportCountryCode

Country where the ranking is calculated. Represented in the ISO 3166 format.

Required in the SELECT clause. Condition on report_country_code is required in the WHERE clause.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getReportCategoryId

Google product category ID to calculate the ranking for, represented in Google's product taxonomy.

Required in the SELECT clause. If a WHERE condition on report_category_id is not specified in the query, rankings for all top-level categories are returned.

Returns
Type	Description
int|string

hasReportCategoryId

clearReportCategoryId

setReportCategoryId

Google product category ID to calculate the ranking for, represented in Google's product taxonomy.

Required in the SELECT clause. If a WHERE condition on report_category_id is not specified in the query, rankings for all top-level categories are returned.

Parameter
Name	Description
var	int|string

Returns
Type	Description
$this

getTitle

Title of the product cluster.

Returns
Type	Description
string

hasTitle

clearTitle

setTitle

Title of the product cluster.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getBrand

Brand of the product cluster.

Returns
Type	Description
string

hasBrand

clearBrand

setBrand

Brand of the product cluster.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getCategoryL1

Product category (1st level) of the product cluster, represented in Google's product taxonomy.

Returns
Type	Description
string

hasCategoryL1

clearCategoryL1

setCategoryL1

Product category (1st level) of the product cluster, represented in Google's product taxonomy.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getCategoryL2

Product category (2nd level) of the product cluster, represented in Google's product taxonomy.

Returns
Type	Description
string

hasCategoryL2

clearCategoryL2

setCategoryL2

Product category (2nd level) of the product cluster, represented in Google's product taxonomy.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getCategoryL3

Product category (3rd level) of the product cluster, represented in Google's product taxonomy.

Returns
Type	Description
string

hasCategoryL3

clearCategoryL3

setCategoryL3

Product category (3rd level) of the product cluster, represented in Google's product taxonomy.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getCategoryL4

Product category (4th level) of the product cluster, represented in Google's product taxonomy.

Returns
Type	Description
string

hasCategoryL4

clearCategoryL4

setCategoryL4

Product category (4th level) of the product cluster, represented in Google's product taxonomy.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getCategoryL5

Product category (5th level) of the product cluster, represented in Google's product taxonomy.

Returns
Type	Description
string

hasCategoryL5

clearCategoryL5

setCategoryL5

Product category (5th level) of the product cluster, represented in Google's product taxonomy.

Parameter
Name	Description
var	string

Returns
Type	Description
$this

getVariantGtins

GTINs of example variants of the product cluster.

Returns
Type	Description
Google\Protobuf\Internal\RepeatedField

setVariantGtins

GTINs of example variants of the product cluster.

Parameter
Name	Description
var	string[]

Returns
Type	Description
$this

getInventoryStatus

Whether the product cluster is IN_STOCK in your product feed in at least one of the countries, OUT_OF_STOCK in your product feed in all countries, or NOT_IN_INVENTORY at all.

The field doesn't take the Best sellers report country filter into account.

Returns
Type	Description
int

hasInventoryStatus

clearInventoryStatus

setInventoryStatus

Whether the product cluster is IN_STOCK in your product feed in at least one of the countries, OUT_OF_STOCK in your product feed in all countries, or NOT_IN_INVENTORY at all.

The field doesn't take the Best sellers report country filter into account.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getBrandInventoryStatus

Whether there is at least one product of the brand currently IN_STOCK in your product feed in at least one of the countries, all products are OUT_OF_STOCK in your product feed in all countries, or NOT_IN_INVENTORY.

The field doesn't take the Best sellers report country filter into account.

Returns
Type	Description
int

hasBrandInventoryStatus

clearBrandInventoryStatus

setBrandInventoryStatus

Whether there is at least one product of the brand currently IN_STOCK in your product feed in at least one of the countries, all products are OUT_OF_STOCK in your product feed in all countries, or NOT_IN_INVENTORY.

The field doesn't take the Best sellers report country filter into account.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getRank

Popularity of the product cluster on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold.

Returns
Type	Description
int|string

hasRank

clearRank

setRank

Popularity of the product cluster on Ads and organic surfaces, in the selected category and country, based on the estimated number of units sold.

Parameter
Name	Description
var	int|string

Returns
Type	Description
$this

getPreviousRank

Popularity rank in the previous week or month.

Returns
Type	Description
int|string

hasPreviousRank

clearPreviousRank

setPreviousRank

Popularity rank in the previous week or month.

Parameter
Name	Description
var	int|string

Returns
Type	Description
$this

getRelativeDemand

Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country.

Returns
Type	Description
int

hasRelativeDemand

clearRelativeDemand

setRelativeDemand

Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getPreviousRelativeDemand

Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country in the previous week or month.

Returns
Type	Description
int

hasPreviousRelativeDemand

clearPreviousRelativeDemand

setPreviousRelativeDemand

Estimated demand in relation to the product cluster with the highest popularity rank in the same category and country in the previous week or month.

Parameter
Name	Description
var	int

Returns
Type	Description
$this

getRelativeDemandChange

Change in the estimated demand. Whether it rose, sank or remained flat.

Returns
Type	Description
int

hasRelativeDemandChange

clearRelativeDemandChange

setRelativeDemandChange

Change in the estimated demand. Whether it rose, sank or remained flat.

Parameter
Name	Description
var	int

Returns
Type	Description
$this