Google Shopping Merchant Reports V1beta Client - Class BestSellersBrandView (0.3.0)

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

Fields available for query in best_sellers_brand_view table.

Best sellers report with top brands. Values are only set for fields requested explicitly in the request's search query.

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

Namespace

Google \ Shopping \ Merchant \ Reports \ V1beta

Methods

__construct

Constructor.

Parameters
NameDescription
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.

↳ brand string

Name of the brand.

↳ rank int|string

Popularity of the brand 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 brand with the highest popularity rank in the same category and country.

↳ previous_relative_demand int

Estimated demand in relation to the brand 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
TypeDescription
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
NameDescription
var Google\Type\Date
Returns
TypeDescription
$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
TypeDescription
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
NameDescription
var int
Returns
TypeDescription
$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
TypeDescription
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
NameDescription
var string
Returns
TypeDescription
$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
TypeDescription
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
NameDescription
var int|string
Returns
TypeDescription
$this

getBrand

Name of the brand.

Returns
TypeDescription
string

hasBrand

clearBrand

setBrand

Name of the brand.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getRank

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

Returns
TypeDescription
int|string

hasRank

clearRank

setRank

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

Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getPreviousRank

Popularity rank in the previous week or month.

Returns
TypeDescription
int|string

hasPreviousRank

clearPreviousRank

setPreviousRank

Popularity rank in the previous week or month.

Parameter
NameDescription
var int|string
Returns
TypeDescription
$this

getRelativeDemand

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

Returns
TypeDescription
int

hasRelativeDemand

clearRelativeDemand

setRelativeDemand

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

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getPreviousRelativeDemand

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

Returns
TypeDescription
int

hasPreviousRelativeDemand

clearPreviousRelativeDemand

setPreviousRelativeDemand

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

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getRelativeDemandChange

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

Returns
TypeDescription
int

hasRelativeDemandChange

clearRelativeDemandChange

setRelativeDemandChange

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

Parameter
NameDescription
var int
Returns
TypeDescription
$this