Package google.mybusiness.performance.v1

ดัชนี

PerformanceService

บริการนี้ช่วยให้ผู้ขายดึงรายงานประสิทธิภาพเกี่ยวกับ Business Profile ของตนใน Google ได้

API จะพยายามทำตามหลักเกณฑ์ที่พบใน aip.dev

FetchMultiDailyMetricsTimeSeries

rpc FetchMultiDailyMetricsTimeSeries(FetchMultiDailyMetricsTimeSeriesRequest) returns (FetchMultiDailyMetricsTimeSeriesResponse)

แสดงค่าสำหรับแต่ละวันจากช่วงเวลาหนึ่งๆ และเลือกประเภทเอนทิตีย่อย (ถ้ามี) ที่เชื่อมโยงกับเมตริกรายวันที่เฉพาะเจาะจง

ตัวอย่างคำขอ: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
GetDailyMetricsTimeSeries

rpc GetDailyMetricsTimeSeries(GetDailyMetricsTimeSeriesRequest) returns (GetDailyMetricsTimeSeriesResponse)

แสดงค่าของแต่ละวันที่จากช่วงเวลาที่ระบุ ซึ่งเชื่อมโยงกับเมตริกรายวันที่เฉพาะเจาะจง

ตัวอย่างคำขอ: 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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
ListSearchKeywordImpressionsMonthly

rpc ListSearchKeywordImpressionsMonthly(ListSearchKeywordImpressionsMonthlyRequest) returns (ListSearchKeywordImpressionsMonthlyResponse)

แสดงคีย์เวิร์ดที่ใช้ค้นหาธุรกิจในการค้นหาหรือแผนที่ คีย์เวิร์ดที่ใช้ค้นหาแต่ละคำมาพร้อมกับการแสดงผล ซึ่งรวบรวมเป็นรายเดือน

ตัวอย่างคำขอ: 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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/business.manage

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0

DailyMetric

แสดงเมตริกรายวันที่มีอยู่ทั้งหมดสำหรับธุรกิจ

Enum
DAILY_METRIC_UNKNOWN แสดงค่าเริ่มต้นที่ไม่รู้จัก
BUSINESS_IMPRESSIONS_DESKTOP_MAPS การแสดงผลของธุรกิจใน Google Maps บนอุปกรณ์เดสก์ท็อป การแสดงผลหลายครั้งโดยผู้ใช้ที่ไม่ซ้ำภายใน 1 วันจะนับเป็นการแสดงผลครั้งเดียว
BUSINESS_IMPRESSIONS_MOBILE_MAPS การแสดงผลของธุรกิจใน Google Maps บนอุปกรณ์เคลื่อนที่ การแสดงผลหลายครั้งโดยผู้ใช้ที่ไม่ซ้ำภายใน 1 วันจะนับเป็นการแสดงผลครั้งเดียว
BUSINESS_CONVERSATIONS จํานวนการสนทนาผ่านข้อความที่ได้รับใน Business Profile
BUSINESS_DIRECTION_REQUESTS จำนวนครั้งที่มีการส่งคำขอเส้นทางไปยังที่ตั้งธุรกิจ
CALL_CLICKS จำนวนครั้งที่มีการคลิกปุ่มโทรของ Business Profile
WEBSITE_CLICKS จำนวนครั้งที่มีการคลิกเว็บไซต์ Business Profile
BUSINESS_BOOKINGS จํานวนการจองที่เกิดจาก Business Profile ผ่าน "จองกับ Google"
BUSINESS_FOOD_ORDERS จํานวนคําสั่งซื้ออาหารที่ได้รับจาก Business Profile
BUSINESS_FOOD_MENU_CLICKS จำนวนคลิกเพื่อดูหรือโต้ตอบกับเนื้อหาในเมนูใน Business Profile การคลิกหลายครั้งโดยผู้ใช้ที่ไม่ซ้ำภายใน 1 วันจะนับเป็น 1

DailyMetricTimeSeries

แสดงจุดข้อมูลเดียว โดยที่แต่ละจุดข้อมูลเป็น Tuple DailyMetric-DailySubEntityType-TimeSeries

ช่อง
daily_metric

DailyMetric

DailyMetric ที่ TimeSeries แสดงถึง
daily_sub_entity_type

DailySubEntityType

DailySubEntityType ที่ TimeSeries แสดง จะไม่แสดงเมื่อไม่มีรายละเอียด
time_series

TimeSeries

รายการจุดข้อมูลที่จุดข้อมูลแต่ละจุดเป็นคู่วันที่-ค่า

DailyRange

ช่วงเวลาที่ระบุช่วงวันที่ (รวมทั้งสองช่วงเวลา)

ช่อง
start_date

Date

ต้องระบุ ไม่มีการแบ่งแยก
end_date

Date

ต้องระบุ ไม่มีการแบ่งแยก

DailySubEntityType

แสดงประเภทเอนทิตีย่อยที่เป็นไปได้ทั้งหมดที่เชื่อมโยงกับ DailyMetrics

ช่อง
ฟิลด์การรวม Type แสดงว่าคุณต้องมีช่อง Proto เพียง 1 ช่องต่อไปนี้เท่านั้น DailySubEntityType ใช้ได้กับเมตริกบางรายการเท่านั้น Type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
day_of_week

DayOfWeek

แสดงวันของสัปดาห์ เช่น MONDAY DailyMetrics = NONE ที่สนับสนุนในปัจจุบัน
time_of_day

TimeOfDay

แสดงเวลาของวันในรูปแบบ 24 ชั่วโมง เช่น DailyMetrics = NONE ที่รองรับในปัจจุบัน 13:34:20

DatedValue

แสดงจุดข้อมูลเดียวในอนุกรมเวลา โดยแต่ละจุดข้อมูลเป็นคู่วันที่-ค่า

ช่อง
date

Date

วันที่ที่ตรงกับจุดข้อมูล ค่านี้แสดงค่าเดือนหากไม่ได้กำหนดช่องวันไว้
value

int64

ค่าของจุดข้อมูล โดยจะไม่แสดงเมื่อค่าเป็น 0

FetchMultiDailyMetricsTimeSeriesRequest

แสดงคำขอ FetchMultiDailyMetricsTimeSeries

ช่อง
location

string

ต้องระบุ ตำแหน่งที่ควรดึงข้อมูลอนุกรมเวลา รูปแบบ: สถานที่ตั้ง/{location_id} โดยที่ location_id เป็นรหัสข้อมูลที่ไม่สร้างความสับสน
daily_metrics[]

DailyMetric

ต้องระบุ เมตริกที่จะดึงอนุกรมเวลา
daily_range

DailyRange

ต้องระบุ ช่วงเวลาที่จะดึงข้อมูลอนุกรมเวลา

FetchMultiDailyMetricsTimeSeriesResponse

แสดงการตอบสนองสำหรับ FetchMultiDailyMetricsTimeSeries

ช่อง
multi_daily_metric_time_series[]

MultiDailyMetricTimeSeries

DailyMetrics และอนุกรมเวลาที่เกี่ยวข้อง

GetDailyMetricsTimeSeriesRequest

แสดงคำขอ GetDailyMetricsTimeSeries

ช่อง
name

string

ต้องระบุ ตำแหน่งที่ควรดึงข้อมูลอนุกรมเวลา รูปแบบ: สถานที่ตั้ง/{location_id} โดยที่ location_id เป็นรหัสข้อมูลที่ไม่สร้างความสับสน
daily_metric

DailyMetric

ต้องระบุ เมตริกสำหรับเรียกดูอนุกรมเวลา
daily_range

DailyRange

ต้องระบุ ช่วงเวลาที่จะดึงข้อมูลอนุกรมเวลา
daily_sub_entity_type

DailySubEntityType

ไม่บังคับ ประเภทเอนทิตีย่อยและรหัสที่เกี่ยวข้องกับอนุกรมเวลา DailyMetrics = NONE ที่สนับสนุนในปัจจุบัน

GetDailyMetricsTimeSeriesResponse

แสดงการตอบกลับสำหรับ GetDailyMetricsTimeSeries

ช่อง
time_series

TimeSeries

อนุกรมเวลาประจำวัน

InsightsValue

แสดงค่าข้อมูลเชิงลึก

ช่อง
ฟิลด์การรวม InsightsValue แสดงว่าคุณต้องมีช่อง Proto เพียง 1 ช่องต่อไปนี้เท่านั้น InsightsValue ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
value

int64

แสดงค่าจริง
threshold

int64

แสดงเกณฑ์ที่ต่ำกว่าค่าจริง

ListSearchKeywordImpressionsMonthlyRequest

แสดงคำขอ ListSearchKeywordImpressionsรายเดือน

ช่อง
parent

string

ต้องระบุ ตำแหน่งที่ควรดึงข้อมูลอนุกรมเวลา รูปแบบ: สถานที่ตั้ง/{location_id} โดยที่ location_id เป็นรหัสข้อมูลที่ไม่สร้างความสับสน
monthly_range

MonthlyRange

ต้องระบุ ช่วงเดือนที่จะรวมการแสดงผลคีย์เวิร์ดในการค้นหา
page_size

int32

ไม่บังคับ จำนวนผลลัพธ์ที่ขอ ขนาดหน้าเริ่มต้นคือ 100 สามารถกำหนดขนาดหน้าเว็บได้สูงสุด 100 หน้า
page_token

bytes

ไม่บังคับ โทเค็นที่ระบุผลลัพธ์ที่ใส่เลขหน้าถัดไปซึ่งจะแสดงขึ้นมา

ListSearchKeywordImpressionsMonthlyResponse

แสดงการตอบกลับสำหรับ ListSearchKeywordImpressionsรายเดือน

ช่อง
search_keywords_counts[]

SearchKeywordCount

ข้อความค้นหาที่ใช้ค้นหาธุรกิจ
next_page_token

bytes

โทเค็นที่ระบุผลลัพธ์ที่ใส่เลขหน้าล่าสุดที่แสดงผล ซึ่งสามารถใช้เมื่อคำขอประสบความสำเร็จเพื่อไปยัง "หน้า" ถัดไปของคีย์เวิร์ด และจะแสดงเมื่อมีผลลัพธ์เพิ่มเติมเท่านั้น

MonthlyRange

ช่วงเวลาที่ระบุช่วงเดือน (รวมทั้งสองแบบ)

ช่อง
start_month

Date

ต้องระบุ รวม - พิจารณาเฉพาะช่องปีและเดือน
end_month

Date

ต้องระบุ รวม - พิจารณาเฉพาะช่องปีและเดือน

MultiDailyMetricTimeSeries

แสดงลิสต์ของ DailyMetric-DailySubEntityType-TimeSeries

ช่อง
daily_metric_time_series[]

DailyMetricTimeSeries

รายการคู่ DailyMetric-TimeSeries

SearchKeywordCount

แสดงคีย์เวิร์ดสำหรับโฆษณา Search คำเดียวและค่าของคีย์เวิร์ดนั้น

ช่อง
search_keyword

string

สตริงตัวพิมพ์เล็กที่ผู้ใช้ป้อน
insights_value

InsightsValue

หนึ่งในค่าใดค่าหนึ่งต่อไปนี้ 1) ผลรวมของจำนวนผู้ใช้ที่ไม่ซ้ำที่ใช้คีย์เวิร์ดในหนึ่งเดือน ผลรวมสำหรับแต่ละเดือนที่ขอ 2) เกณฑ์ที่แสดงว่าค่าจริงต่ำกว่าเกณฑ์นี้

TimeSeries

แสดงอนุกรมเวลา

ช่อง
dated_values[]

DatedValue

รายการจุดข้อมูลในอนุกรมเวลา โดยจุดข้อมูลแต่ละจุดเป็นคู่วันที่-ค่า