Business Profile Performance API (businessprofileperformance:v1)

2022-05-30

2 new methods | New API

Additions

    Methods
  • businessprofileperformance.locations.getDailyMetricsTimeSeries

      Description: Returns the values for each date from a given time range that are associated with the specific daily metric. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31

      Path: v1/{+name}:getDailyMetricsTimeSeries

      HTTP Method: GET

      Flat Path: v1/locations/{locationsId}:getDailyMetricsTimeSeries

      Parameter Order: name

      Parameters:

        dailyRange.endDate.day

          Location: query

          Format: int32

          Type: integer

          Description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

        dailySubEntityType.timeOfDay.minutes

          Description: Minutes of hour of day. Must be from 0 to 59.

          Location: query

          Format: int32

          Type: integer

        dailyMetric

          Enum:

        • DAILY_METRIC_UNKNOWN
        • BUSINESS_IMPRESSIONS_DESKTOP_MAPS
        • BUSINESS_IMPRESSIONS_DESKTOP_SEARCH
        • BUSINESS_IMPRESSIONS_MOBILE_MAPS
        • BUSINESS_IMPRESSIONS_MOBILE_SEARCH
        • BUSINESS_CONVERSATIONS
        • BUSINESS_DIRECTION_REQUESTS
        • CALL_CLICKS
        • WEBSITE_CLICKS
        • BUSINESS_BOOKINGS
        • BUSINESS_FOOD_ORDERS
        • Location: query

          Description: Required. The metric to retrieve time series.

          Type: string

          Enum Descriptions:

        • Represents the default unknown value.
        • Business impressions on Google Maps on Desktop devices. Multiple impressions by a unique user within a single day are counted as a single impression.
        • Business impressions on Google Search on Desktop devices. Multiple impressions by a unique user within a single day are counted as a single impression.
        • Business impressions on Google Maps on Mobile devices. Multiple impressions by a unique user within a single day are counted as a single impression.
        • Business impressions on Google Search on Mobile devices. Multiple impressions by a unique user within a single day are counted as a single impression.
        • The number of message conversations received on the business profile.
        • The number of times a direction request was requested to the business location.
        • The number of times the business profile call button was clicked.
        • The number of times the business profile website was clicked.
        • The number of bookings received from the business profile.
        • The number of food orders received from the business profile.

        dailyRange.endDate.year

          Location: query

          Type: integer

          Format: int32

          Description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

        dailyRange.startDate.year

          Location: query

          Format: int32

          Type: integer

          Description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

        dailyRange.startDate.month

          Format: int32

          Location: query

          Description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.

          Type: integer

        dailySubEntityType.timeOfDay.nanos

          Format: int32

          Description: Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.

          Type: integer

          Location: query

        dailyRange.endDate.month

          Format: int32

          Description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.

          Location: query

          Type: integer

        name

          Required: Yes

          Type: string

          Description: Required. The location for which the time series should be fetched. Format: locations/{location_id} where location_id is an unobfuscated listing id.

          Pattern: ^locations/[^/]+$

          Location: path

        dailySubEntityType.timeOfDay.hours

          Type: integer

          Format: int32

          Description: Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.

          Location: query

        dailyRange.startDate.day

          Format: int32

          Description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

          Type: integer

          Location: query

        dailySubEntityType.dayOfWeek

          Description: Represents the day of the week. Eg: MONDAY.

          Type: string

          Enum:

        • DAY_OF_WEEK_UNSPECIFIED
        • MONDAY
        • TUESDAY
        • WEDNESDAY
        • THURSDAY
        • FRIDAY
        • SATURDAY
        • SUNDAY
        • Location: query

          Enum Descriptions:

        • The day of the week is unspecified.
        • Monday
        • Tuesday
        • Wednesday
        • Thursday
        • Friday
        • Saturday
        • Sunday

        dailySubEntityType.timeOfDay.seconds

          Location: query

          Format: int32

          Description: Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.

          Type: integer

  • businessprofileperformance.locations.searchkeywords.impressions.monthly.list

      Path: v1/{+parent}/searchkeywords/impressions/monthly

      Description: Returns the search keywords used to find a business in search or maps. Each search keyword is accompanied by impressions which are aggregated on a monthly basis. Example request: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3

      Parameters:

        monthlyRange.startMonth.day

          Format: int32

          Type: integer

          Description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

          Location: query

        monthlyRange.startMonth.month

          Description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.

          Type: integer

          Location: query

          Format: int32

        monthlyRange.endMonth.year

          Type: integer

          Location: query

          Description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

          Format: int32

        pageToken

          Format: byte

          Description: Optional. A token indicating the next paginated result to be returned.

          Location: query

          Type: string

        monthlyRange.endMonth.month

          Type: integer

          Format: int32

          Location: query

          Description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.

        pageSize

          Description: Optional. The number of results requested. The default page size is 100. Page size can be set to a maximum of 100.

          Type: integer

          Format: int32

          Location: query

        monthlyRange.endMonth.day

          Location: query

          Description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

          Format: int32

          Type: integer

        parent

          Type: string

          Location: path

          Required: Yes

          Pattern: ^locations/[^/]+$

          Description: Required. The location for which the time series should be fetched. Format: locations/{location_id} where location_id is an unobfuscated listing id.

        monthlyRange.startMonth.year

          Format: int32

          Location: query

          Description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

          Type: integer

      Flat Path: v1/locations/{locationsId}/searchkeywords/impressions/monthly

      HTTP Method: GET

      Parameter Order: parent