Package google.mybusiness.v4

ดัชนี

AccessControl

บริการนี้ช่วยให้สามารถจัดการผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชีและสถานที่ตั้ง

AcceptInvitation

rpc AcceptInvitation(AcceptInvitationRequest) returns (Empty)

ยอมรับคำเชิญที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

CreateAccountAdmin

rpc CreateAccountAdmin(CreateAccountAdminRequest) returns (Admin)

เชิญผู้ใช้ที่ระบุให้เป็นผู้ดูแลระบบสำหรับบัญชีที่ระบุ ผู้ได้รับเชิญต้องยอมรับคำเชิญจึงจะได้รับสิทธิ์เข้าถึงบัญชี ดู [ตอบรับคำเชิญ] [google.mybusiness.v4.ตอบรับคำเชิญ] เพื่อยอมรับคำเชิญทางโปรแกรม

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

CreateLocationAdmin

rpc CreateLocationAdmin(CreateLocationAdminRequest) returns (Admin)

เชิญผู้ใช้ที่ระบุให้เป็นผู้ดูแลระบบของสถานที่ที่ระบุ ผู้ได้รับเชิญต้องยอมรับคำเชิญจึงจะได้รับสิทธิ์เข้าถึงสถานที่ ดู [ตอบรับคำเชิญ] [google.mybusiness.v4.ตอบรับคำเชิญ] เพื่อยอมรับคำเชิญทางโปรแกรม

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeclineInvitation

rpc DeclineInvitation(DeclineInvitationRequest) returns (Empty)

ปฏิเสธคำเชิญที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteAccountAdmin

rpc DeleteAccountAdmin(DeleteAccountAdminRequest) returns (Empty)

นำผู้ดูแลระบบที่ระบุออกจากบัญชีที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteLocationAdmin

rpc DeleteLocationAdmin(DeleteLocationAdminRequest) returns (Empty)

นำผู้ดูแลระบบที่ระบุออกจากการเป็นผู้จัดการของสถานที่ที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListAccountAdmins

rpc ListAccountAdmins(ListAccountAdminsRequest) returns (ListAccountAdminsResponse)

แสดงผู้ดูแลระบบสำหรับบัญชีที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListInvitations

rpc ListInvitations(ListInvitationsRequest) returns (ListInvitationsResponse)

แสดงรายการคำเชิญที่รอดำเนินการสำหรับบัญชีที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListLocationAdmins

rpc ListLocationAdmins(ListLocationAdminsRequest) returns (ListLocationAdminsResponse)

แสดงผู้ดูแลระบบทั้งหมดของสถานที่ที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateAccountAdmin

rpc UpdateAccountAdmin(UpdateAccountAdminRequest) returns (Admin)

อัปเดตผู้ดูแลระบบสำหรับผู้ดูแลบัญชีที่ระบุ อัปเดตได้เฉพาะบทบาทการดูแลระบบของผู้ดูแลระบบ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateLocationAdmin

rpc UpdateLocationAdmin(UpdateLocationAdminRequest) returns (Admin)

อัปเดตผู้ดูแลระบบสำหรับผู้ดูแลระบบสถานที่ตั้งที่ระบุ อัปเดตได้เฉพาะบทบาทการดูแลระบบของผู้ดูแลระบบ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

บัญชี

API นี้ช่วยให้จัดการบัญชีธุรกิจใน Google ได้ ให้คุณจัดการทรัพยากร Account ได้ และกำหนดโมเดลทรัพยากรต่อไปนี้

  • API มีคอลเล็กชันของทรัพยากร Account รายการ ชื่อ accounts/*

  • เพื่อความสะดวก คุณสามารถใช้คำพ้องความหมาย "ฉัน" แทนรหัสบัญชีสำหรับบัญชีส่วนตัวของผู้โทรที่ตรวจสอบสิทธิ์แล้ว ตัวอย่าง: GET /v4/accounts/me GET /v4/accounts/me/locations

CreateAccount

rpc CreateAccount(CreateAccountRequest) returns (Account)

สร้างบัญชีที่มีชื่อและประเภทที่ระบุภายใต้รายการหลักที่ระบุ

  • สร้างบัญชีส่วนตัวและองค์กรไม่ได้
  • ไม่สามารถสร้างกลุ่มผู้ใช้ด้วยบัญชีส่วนตัวในฐานะเจ้าของหลัก
  • ทั้งนี้ คุณจะสร้างกลุ่มสถานที่ตั้งโดยมีเจ้าของหลักของบัญชีส่วนตัวไม่ได้หากบัญชีส่วนบุคคลอยู่ในองค์กร
  • กลุ่มสถานที่ตั้งไม่สามารถเป็นเจ้าของกลุ่มสถานที่ตั้งได้

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteNotifications

rpc DeleteNotifications(DeleteNotificationsRequest) returns (Empty)

ล้างการตั้งค่าการแจ้งเตือน PubSub สำหรับบัญชี

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GenerateAccountNumber

rpc GenerateAccountNumber(GenerateAccountNumberRequest) returns (Account)

สร้างหมายเลขบัญชีสำหรับบัญชีนี้ เมื่อสร้างบัญชีแล้วจะไม่ได้รับการจัดสรรหมายเลขบัญชีดังกล่าว ใช้คําขอนี้เพื่อสร้างหมายเลขบัญชีเมื่อจําเป็น

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

รับบัญชีที่ระบุ แสดงผล NOT_FOUND หากไม่มีบัญชีอยู่หรือผู้โทรไม่มีสิทธิ์เข้าถึงบัญชี

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetNotifications

rpc GetNotifications(GetNotificationsRequest) returns (Notifications)

แสดงการตั้งค่าการแจ้งเตือน pubsub สำหรับบัญชี

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

แสดงบัญชีทั้งหมดของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ซึ่งรวมถึงบัญชีทั้งหมดที่ผู้ใช้เป็นเจ้าของ และบัญชีที่ผู้ใช้มีสิทธิ์ในการจัดการ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

อัปเดตบัญชีธุรกิจที่ระบุ ไม่สามารถอัปเดตบัญชีส่วนบุคคลด้วยวิธีนี้ได้

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateNotifications

rpc UpdateNotifications(UpdateNotificationsRequest) returns (Notifications)

ตั้งค่าการแจ้งเตือน pubsub สำหรับบัญชีเพื่อแจ้ง Business Profile ว่าควรส่งการแจ้งเตือน pubsub สำหรับหัวข้อใด

  • รีวิวใหม่สำหรับสถานที่ที่บัญชีดูแล
  • รีวิวที่อัปเดตสำหรับสถานที่ที่ดูแลโดยบัญชี
  • GoogleUpdates ใหม่สำหรับสถานที่ที่บัญชีดูแล

โดยบัญชีจะมีทรัพยากรการตั้งค่าการแจ้งเตือนได้เพียง 1 รายการเท่านั้น และจะตั้งค่าหัวข้อ PubSub ได้เพียงรายการเดียว

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

BusinessCategories

API นี้ช่วยให้เห็นหมวดหมู่ที่รองรับสำหรับที่ตั้งธุรกิจบน Google คุณสามารถดูรายการที่ใส่เลขหน้าของหมวดหมู่ธุรกิจทั้งหมดที่มี หรือค้นหาโดยใช้คำที่เฉพาะเจาะจงก็ได้ สำหรับข้อมูลอ้างอิง โปรดดูที่ส่วนหมวดหมู่ของบทความนี้ https://support.google.com/business/answer/3038177

BatchGetBusinessCategories

rpc BatchGetBusinessCategories(BatchGetBusinessCategoriesRequest) returns (BatchGetBusinessCategoriesResponse)

แสดงผลรายการหมวดหมู่ธุรกิจสำหรับภาษาและรหัส GConcept ที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListBusinessCategories

rpc ListBusinessCategories(ListBusinessCategoriesRequest) returns (ListBusinessCategoriesResponse)

แสดงผลรายการหมวดหมู่ธุรกิจ การค้นหาจะจับคู่ชื่อหมวดหมู่ แต่ไม่ตรงกับรหัสหมวดหมู่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

BusinessMessagingService

ช่วยให้ธุรกิจลงทะเบียนสถานที่ตั้งของตนสำหรับการรับส่งข้อความของธุรกิจ เพื่อเปิดใช้ช่องทางการสื่อสารจากผู้บริโภคที่ค้นหาสถานที่ของตน หากต้องการดูและดำเนินการเกี่ยวกับการรับส่งข้อความของธุรกิจของสถานที่ คุณต้องเป็นบุคคล MANAGER หรือ OWNER ของสถานที่นั้น

ผู้ติดตาม

API นี้จะแสดง API การจัดการของผู้ติดตาม

GetFollowersMetadata

rpc GetFollowersMetadata(GetFollowersMetadataRequest) returns (FollowersMetadata)

เรียกดูการตั้งค่าผู้ติดตามสำหรับสถานที่

ระบบจะไม่ส่งคืน NOT_FOUND หากไม่มีบัญชีหรือสถานที่ตั้ง ระบบจะส่งคืน PRECONDITION_FAILED หากสถานที่ไม่ได้รับการยืนยันหรือเชื่อมต่อกับ Maps

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

FoodMenuService

API นี้ช่วยให้ได้รับและอัปเดตเมนูอาหารของที่ตั้งธุรกิจ

โปรดทราบว่า Location.PriceList ไม่ได้แสดง "เมนู" ด้วย อยู่ในประเภทใดประเภทหนึ่งแต่มีฟิลด์จำกัด โดยใช้พื้นที่เก็บข้อมูลดาวน์สตรีมเดียวกับเมนูอาหาร เมื่อย้ายข้อมูลไปยัง FoodMenuService เสร็จแล้ว เราไม่แนะนำให้ลูกค้าใช้ Location.PriceList เพื่ออัปเดตข้อมูลเมนูอีกต่อไป ซึ่งอาจส่งผลให้ข้อมูลสูญหายโดยไม่คาดคิด

GetFoodMenus

rpc GetFoodMenus(GetFoodMenusRequest) returns (FoodMenus)

แสดงเมนูอาหารของสถานที่หนึ่งๆ เรียกใช้เมนูนี้เฉพาะเมื่อ location.location_state.can_have_food_เมนู เป็น "จริง" เท่านั้น

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateFoodMenus

rpc UpdateFoodMenus(UpdateFoodMenusRequest) returns (FoodMenus)

อัปเดตเมนูอาหารของสถานที่บางแห่ง เรียกใช้เมนูนี้เฉพาะเมื่อ location.location_state.can_have_food_เมนู เป็น "จริง" เท่านั้น

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GoogleLocations

API นี้อนุญาตให้เข้าถึงและค้นหา GoogleLocation

ListRecommendedGoogleLocations

rpc ListRecommendedGoogleLocations(ListRecommendedGoogleLocationsRequest) returns (ListRecommendedGoogleLocationsResponse)

แสดงรายการ GoogleLocation ทั้งหมดที่แนะนำสำหรับบัญชี Business Profile ที่ระบุ คําแนะนํามีให้สําหรับบัญชีส่วนตัวและกลุ่มสถานที่ตั้งเท่านั้น คําขอสําหรับบัญชีประเภทอื่นๆ ทั้งหมดจะเกิดข้อผิดพลาด คำแนะนำสำหรับกลุ่มสถานที่ตั้งจะขึ้นอยู่กับสถานที่ตั้งในกลุ่มนั้น

คำแนะนำสำหรับบัญชีส่วนบุคคลจะอิงตามสถานที่ทั้งหมดที่ผู้ใช้มีสิทธิ์เข้าถึงใน Business Profile (ซึ่งรวมถึงสถานที่ที่ผู้ใช้เข้าถึงได้ผ่านกลุ่มสถานที่ตั้ง) และเป็นชุดหลักของคำแนะนำทั้งหมดที่สร้างขึ้นสำหรับผู้ใช้

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ReportGoogleLocation

rpc ReportGoogleLocation(ReportGoogleLocationRequest) returns (Empty)

รายงานGoogleLocation

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

ค้นหาสถานที่ตั้งที่เป็นไปได้ทั้งหมดที่ตรงกับคำขอที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

HealthProviderAttributesService

บริการนี้ช่วยให้คุณจัดการแอตทริบิวต์ของผู้ให้บริการสาธารณสุข (เช่น ประกันที่สถานที่ยอมรับ) ที่ลิงก์กับสถานที่

GetHealthProviderAttributes

rpc GetHealthProviderAttributes(GetHealthProviderAttributesRequest) returns (HealthProviderAttributes)

แสดงแอตทริบิวต์ผู้ให้บริการด้านสุขภาพของตำแหน่งที่เจาะจง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateHealthProviderAttributes

rpc UpdateHealthProviderAttributes(UpdateHealthProviderAttributesRequest) returns (HealthProviderAttributes)

อัปเดตแอตทริบิวต์ผู้ให้บริการสาธารณสุขของสถานที่ตั้งหนึ่งๆ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ข้อมูลเชิงลึก

สร้างรายงานที่มีรายละเอียดข้อมูลเชิงลึกเกี่ยวกับผู้บริโภคสำหรับข้อมูลอย่างน้อย 1 รายการในบริการของ Google คุณสามารถค้นหาข้อมูลรวมสำหรับเมตริกพื้นฐานได้ในช่วงเวลาสูงสุด 18 เดือน เมตริกที่สนับสนุนรายละเอียดสามารถแสดงข้อมูลรวมในช่วงนี้โดยแยกตามวันของสัปดาห์หรือชั่วโมงของวันได้ คุณรายงานคำขอเส้นทางการขับขี่ในภาพรวมเป็นจำนวนวันที่เลือกได้

ReportLocalPostInsights

rpc ReportLocalPostInsights(ReportLocalPostInsightsRequest) returns (ReportLocalPostInsightsResponse)

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

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ReportLocationInsights

rpc ReportLocationInsights(ReportLocationInsightsRequest) returns (ReportLocationInsightsResponse)

แสดงผลรายงานที่มีข้อมูลเชิงลึกของเมตริกอย่างน้อย 1 รายการตามสถานที่ตั้ง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

InsuranceNetworkService

บริการนี้ช่วยให้คุณได้รับเครือข่ายการประกันทั้งหมดที่รองรับสำหรับที่ตั้งธุรกิจด้านสุขภาพบน Google

ListInsuranceNetworks

rpc ListInsuranceNetworks(ListInsuranceNetworksRequest) returns (ListInsuranceNetworksResponse)

แสดงรายการเครือข่ายการประกันทั้งหมดที่ Google รองรับ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

LocalPosts

API นี้จะแสดง API การจัดการของโพสต์ในเครื่อง

CreateLocalPost

rpc CreateLocalPost(CreateLocalPostRequest) returns (LocalPost)

สร้างโพสต์ในพื้นที่ใหม่ที่เชื่อมโยงกับสถานที่ตั้งที่ระบุและส่งกลับ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteLocalPost

rpc DeleteLocalPost(DeleteLocalPostRequest) returns (Empty)

ลบโพสต์ในเครื่อง แสดงผล NOT_FOUND หากไม่มีโพสต์ในเครื่อง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetLocalPost

rpc GetLocalPost(GetLocalPostRequest) returns (LocalPost)

รับโพสต์ในพื้นที่ที่ระบุ แสดงผล NOT_FOUND หากไม่มีโพสต์ในเครื่อง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListLocalPosts

rpc ListLocalPosts(ListLocalPostsRequest) returns (ListLocalPostsResponse)

แสดงรายการโพสต์ในท้องถิ่นที่เชื่อมโยงกับสถานที่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateLocalPost

rpc UpdateLocalPost(UpdateLocalPostRequest) returns (LocalPost)

อัปเดตโพสต์ในพื้นที่ที่ระบุและแสดงโพสต์ในพื้นที่ที่อัปเดตแล้ว

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ตำแหน่ง

API นี้ช่วยให้จัดการที่ตั้งธุรกิจบน Google ได้ ให้คุณจัดการทรัพยากร Location ได้ และกำหนดโมเดลทรัพยากรต่อไปนี้

  • API มีคอลเล็กชันของทรัพยากร Account รายการ ชื่อ accounts/*

  • เพื่อความสะดวก คุณสามารถใช้คำพ้องความหมาย "ฉัน" แทนรหัสบัญชีสำหรับบัญชีส่วนตัวของผู้โทรที่ตรวจสอบสิทธิ์แล้ว ตัวอย่าง: GET /v4/accounts/me GET /v4/accounts/me/locations

  • Account แต่ละรายการมีคอลเล็กชันของทรัพยากร Location รายการ ชื่อ accounts/*/locations/*

AssociateLocation

rpc AssociateLocation(AssociateLocationRequest) returns (Empty)

เชื่อมโยงสถานที่ตั้งกับรหัสสถานที่ ระบบจะเขียนทับการเชื่อมโยงก่อนหน้า การดำเนินการนี้จะใช้ได้ต่อเมื่อสถานที่ไม่ได้รับการยืนยัน การเชื่อมโยงต้องถูกต้อง กล่าวคือการเชื่อมโยงปรากฏในรายการของ FindMatchingLocations

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

BatchGetLocations

rpc BatchGetLocations(BatchGetLocationsRequest) returns (BatchGetLocationsResponse)

ดึงสถานที่ตั้งที่ระบุในบัญชีที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ClearLocationAssociation

rpc ClearLocationAssociation(ClearLocationAssociationRequest) returns (Empty)

ล้างการเชื่อมโยงระหว่างสถานที่ตั้งกับรหัสสถานที่ การดำเนินการนี้จะใช้ได้ต่อเมื่อสถานที่ไม่ได้รับการยืนยัน

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

สร้าง location ใหม่ที่เป็นของบัญชีที่ระบุและส่งคืน

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

ลบสถานที่ตั้ง

FindMatchingLocations

rpc FindMatchingLocations(FindMatchingLocationsRequest) returns (FindMatchingLocationsResponse)

ค้นหาสถานที่ตั้งที่เป็นไปได้ทั้งหมดที่ตรงกับสถานที่ตั้งที่ระบุ การดำเนินการนี้จะใช้ได้ต่อเมื่อสถานที่ไม่ได้รับการยืนยัน

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

รับเชนที่ระบุ แสดงผล NOT_FOUND หากไม่มีเชนอยู่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetLocationRequest) returns (GoogleUpdatedLocation)

รับตำแหน่งที่ระบุในเวอร์ชันที่ Google อัปเดต แสดงผล NOT_FOUND หากไม่มีตำแหน่งอยู่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

รับตำแหน่งที่ตั้ง

rpc GetLocation(GetLocationRequest) returns (Location)

รับตำแหน่งที่ระบุ แสดงผล NOT_FOUND หากไม่มีตำแหน่งอยู่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

แสดงรายการแอตทริบิวต์ที่ใช้ได้ซึ่งจะพร้อมใช้งานสำหรับสถานที่ซึ่งมีหมวดหมู่หลักและประเทศที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListLocation

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

แสดงสถานที่ตั้งสำหรับบัญชีที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

ค้นหาเชนตามชื่อของเชน

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

TransferLocation

rpc TransferLocation(TransferLocationRequest) returns (Location)

ย้ายสถานที่ตั้งจากบัญชีที่ผู้ใช้เป็นเจ้าของไปยังบัญชีอื่นที่ผู้ใช้รายเดียวกันดูแลอยู่ ผู้ใช้ต้องเป็นเจ้าของบัญชีที่เชื่อมโยงกับสถานที่ตั้งอยู่ในปัจจุบัน และต้องเป็นผู้จัดการของบัญชีปลายทางเป็นอย่างน้อย แสดงผลตำแหน่งพร้อมด้วยชื่อทรัพยากรใหม่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

อัปเดตตำแหน่งที่ระบุ

สามารถใช้รูปภาพได้เฉพาะในตำแหน่งที่มี Google+ เพจเท่านั้น

แสดงผล NOT_FOUND หากไม่มีตำแหน่งอยู่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

สื่อ

บริการนี้ช่วยให้คุณจัดการสื่อ (รูปภาพและวิดีโอ) ที่ลิงก์กับสถานที่ได้

CreateMediaItem

rpc CreateMediaItem(CreateMediaItemRequest) returns (MediaItem)

สร้างรายการสื่อใหม่สำหรับสถานที่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteMediaItem

rpc DeleteMediaItem(DeleteMediaItemRequest) returns (Empty)

ลบรายการสื่อที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetCustomerMediaItem

rpc GetCustomerMediaItem(GetCustomerMediaItemRequest) returns (MediaItem)

แสดงผลข้อมูลเมตาสำหรับรายการสื่อของลูกค้าที่ขอ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetMediaItem

rpc GetMediaItem(GetMediaItemRequest) returns (MediaItem)

แสดงผลข้อมูลเมตาสำหรับรายการสื่อที่ขอ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListCustomerMediaItems

rpc ListCustomerMediaItems(ListCustomerMediaItemsRequest) returns (ListCustomerMediaItemsResponse)

แสดงผลรายการของสื่อที่เชื่อมโยงกับสถานที่ตั้งที่ลูกค้ามีส่วนร่วม

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListMediaItems

rpc ListMediaItems(ListMediaItemsRequest) returns (ListMediaItemsResponse)

แสดงผลรายการสื่อที่เชื่อมโยงกับตำแหน่ง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

StartUploadMediaItemData

rpc StartUploadMediaItemData(StartUploadMediaItemDataRequest) returns (MediaItemDataRef)

สร้าง MediaItemDataRef สำหรับการอัปโหลดรายการสื่อ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateMediaItem

rpc UpdateMediaItem(UpdateMediaItemRequest) returns (MediaItem)

อัปเดตข้อมูลเมตาของรายการสื่อที่ระบุ ใช้เพื่ออัปเดตหมวดหมู่ของรายการสื่อเท่านั้น โดยมีข้อยกเว้นว่าหมวดหมู่ใหม่จะเป็น COVER หรือ PROFILE ไม่ได้

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

QuestionsAndAnswers

บริการนี้อนุญาตให้จัดการคำถามและคำตอบของสถานที่ได้ การดำเนินการถามและตอบจะใช้ได้กับสถานที่ที่ยืนยันแล้วเท่านั้น

CreateQuestion

rpc CreateQuestion(CreateQuestionRequest) returns (Question)

เพิ่มคำถามสำหรับสถานที่ตั้งที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteAnswer

rpc DeleteAnswer(DeleteAnswerRequest) returns (Empty)

ลบคำตอบที่ผู้ใช้ปัจจุบันเขียนสำหรับคำถาม

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteQuestion

rpc DeleteQuestion(DeleteQuestionRequest) returns (Empty)

ลบคำถามเฉพาะที่เขียนโดยผู้ใช้ปัจจุบัน

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListAnswers

rpc ListAnswers(ListAnswersRequest) returns (ListAnswersResponse)

แสดงรายการคำตอบของคำถามที่ระบุที่มีเลขหน้า

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListQuestions

rpc ListQuestions(ListQuestionsRequest) returns (ListQuestionsResponse)

แสดงรายการคำถามที่มีเลขหน้าและคำตอบบางส่วนสำหรับตำแหน่งที่ระบุ

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateQuestion

rpc UpdateQuestion(UpdateQuestionRequest) returns (Question)

อัปเดตคำถามเฉพาะที่เขียนโดยผู้ใช้ปัจจุบัน

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpsertAnswer

rpc UpsertAnswer(UpsertAnswerRequest) returns (Answer)

สร้างคำตอบหรืออัปเดตคำตอบที่มีอยู่ซึ่งเขียนโดยผู้ใช้สำหรับคำถามที่ระบุ ผู้ใช้สามารถสร้างคำตอบได้เพียงคำตอบเดียวต่อคำถาม

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

การตรวจสอบ

API นี้มีการดำเนินการ CRUD สำหรับรีวิว google.mybusiness.v4.Reviews

BatchGetReviews

rpc BatchGetReviews(BatchGetReviewsRequest) returns (BatchGetReviewsResponse)

ส่งกลับรายการรีวิวที่มีเลขหน้าสำหรับสถานที่ที่ระบุทั้งหมด การดำเนินการนี้จะมีผลก็ต่อเมื่อสถานที่ตั้งที่ระบุได้รับการยืนยันแล้วเท่านั้น

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

DeleteReviewReply

rpc DeleteReviewReply(DeleteReviewReplyRequest) returns (Empty)

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

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

GetReview

rpc GetReview(GetReviewRequest) returns (Review)

แสดงรีวิวที่ระบุ การดำเนินการนี้จะใช้ได้เมื่อมีการยืนยันตำแหน่งที่ระบุแล้วเท่านั้น แสดงผล NOT_FOUND หากรีวิวไม่มีอยู่หรือถูกลบไปแล้ว

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListReviews

rpc ListReviews(ListReviewsRequest) returns (ListReviewsResponse)

ส่งกลับรายการรีวิวที่มีเลขหน้าสำหรับสถานที่ที่ระบุ การดำเนินการนี้จะใช้ได้เมื่อมีการยืนยันตำแหน่งที่ระบุแล้วเท่านั้น

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateReviewReply

rpc UpdateReviewReply(UpdateReviewReplyRequest) returns (ReviewReply)

อัปเดตการตอบรีวิวที่ระบุ ระบบจะสร้างการตอบกลับหากยังไม่มีการตอบกลับ การดำเนินการนี้จะใช้ได้เมื่อมีการยืนยันตำแหน่งที่ระบุแล้วเท่านั้น

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ServiceLists

API นี้ช่วยให้การดำเนินการรับและอัปเดตรายการบริการของที่ตั้งธุรกิจบน Google ได้ รายการบริการประกอบด้วยรายการบริการต่างๆ ที่ผู้ขายจัดหาให้ บริการอาจตัดผม ติดตั้งเครื่องทำน้ำอุ่น เป็นต้น

GetServiceList

rpc GetServiceList(GetServiceListRequest) returns (ServiceList)

รับรายการบริการที่ระบุของสถานที่ตั้ง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

UpdateServiceList

rpc UpdateServiceList(UpdateServiceListRequest) returns (ServiceList)

อัปเดตรายการบริการที่ระบุของสถานที่ตั้ง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

การยืนยัน

API นี้ช่วยให้จัดการการยืนยันตำแหน่งใน Google ได้ ให้คุณจัดการทรัพยากร Verification ได้

Location แต่ละรายการมีคอลเล็กชันของทรัพยากร Verification ชื่อ accounts/*/locations/*/verifications/*

CompleteVerification

rpc CompleteVerification(CompleteVerificationRequest) returns (CompleteVerificationResponse)

ทำการยืนยันPENDINGให้เสร็จสมบูรณ์

จำเป็นสำหรับการยืนยันที่ไม่ใช่ AUTO เท่านั้น คำขอการยืนยัน AUTO จะดำเนินการ VERIFIED ทันทีเมื่อมีการสร้าง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

FetchVerificationOptions

rpc FetchVerificationOptions(FetchVerificationOptionsRequest) returns (FetchVerificationOptionsResponse)

รายงานตัวเลือกการยืนยันที่มีสิทธิ์ทั้งหมดสำหรับสถานที่ตั้งหนึ่งๆ เป็นภาษาใดภาษาหนึ่ง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ListVerifications

rpc ListVerifications(ListVerificationsRequest) returns (ListVerificationsResponse)

แสดงรายการการยืนยันสถานที่เรียงลำดับตามเวลาที่สร้าง

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

VerifyLocation

rpc VerifyLocation(VerifyLocationRequest) returns (VerifyLocationResponse)

เริ่มกระบวนการยืนยันสำหรับสถานที่

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

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

AcceptInvitationRequest

ขอข้อความสำหรับ AccessControl.ยอมรับข้อตกลง

ช่อง
name

string

ชื่อของคำเชิญที่จะได้รับการยอมรับ

บัญชี

บัญชีคือคอนเทนเนอร์สำหรับสถานที่ตั้งของธุรกิจ คุณใช้บัญชี Google ส่วนบุคคลได้หากคุณเป็นผู้เดียวที่จัดการสถานที่ตั้งของธุรกิจ หากต้องการแชร์การจัดการสถานที่กับผู้ใช้หลายคน โปรดสร้างบัญชีธุรกิจ

ช่อง
name

string

ชื่อทรัพยากรในรูปแบบ accounts/{account_id}

account_name

string

ชื่อบัญชี

type

AccountType

เอาต์พุตเท่านั้น ระบุ AccountType ของบัญชีนี้

role

AccountRole

เอาต์พุตเท่านั้น ระบุ AccountRole ที่ผู้โทรมีสำหรับบัญชีนี้

state

AccountState

เอาต์พุตเท่านั้น ระบุ AccountState ของบัญชีนี้

account_number

string

หมายเลขอ้างอิงบัญชี (หากมี)

permission_level

PermissionLevel

เอาต์พุตเท่านั้น ระบุ PermissionLevel ที่ผู้โทรมีสำหรับบัญชีนี้

organization_info

OrganizationInfo

ข้อมูลเพิ่มเติมสำหรับองค์กร ข้อมูลนี้เป็นข้อมูลสำหรับบัญชีขององค์กรเท่านั้น

OrganizationInfo

ข้อมูลเพิ่มเติมที่จัดเก็บไว้สำหรับองค์กร

ช่อง
registered_domain

string

โดเมนที่ลงทะเบียนสำหรับบัญชี

postal_address

PostalAddress

ที่อยู่ไปรษณีย์ของบัญชี

phone_number

string

หมายเลขติดต่อขององค์กร

AccountRole

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

Enum
ACCOUNT_ROLE_UNSPECIFIED ไม่ได้ระบุ
OWNER ผู้ใช้เป็นเจ้าของบัญชีนี้ (แสดงเป็น "เจ้าของหลัก" ใน UI)
CO_OWNER ผู้ใช้เป็นเจ้าของร่วมของบัญชี (แสดงเป็น "เจ้าของ" ใน UI)
MANAGER ผู้ใช้จัดการบัญชีนี้ได้
COMMUNITY_MANAGER ผู้ใช้จะจัดการหน้าโซเชียล (Google+) ของบัญชีได้ (แสดงเป็น "Site Manager" ใน UI)

AccountState

ระบุสถานะของบัญชี เช่น บัญชีได้รับการยืนยันโดย Google หรือไม่

ช่อง
status

AccountStatus

หากได้รับการยืนยัน สถานที่ในอนาคตที่สร้างขึ้นจะเชื่อมต่อกับ Google Maps โดยอัตโนมัติ และมีการสร้าง Google+ เพจโดยไม่ต้องมีการกลั่นกรอง

AccountStatus

ระบุสถานะการยืนยันของบัญชี

Enum
ACCOUNT_STATUS_UNSPECIFIED ไม่ได้ระบุ
VERIFIED บัญชีที่ได้รับการยืนยัน
UNVERIFIED บัญชีที่ไม่ได้รับการยืนยัน และยังไม่มีคำขอการยืนยัน
VERIFICATION_REQUESTED บัญชีที่ไม่ได้รับการยืนยัน แต่ได้รับคำขอการยืนยัน

AccountType

ระบุประเภทของบัญชีนี้ อันได้แก่ บัญชีส่วนตัว/บัญชีผู้ใช้ หรือบัญชีธุรกิจ

Enum
ACCOUNT_TYPE_UNSPECIFIED ไม่ได้ระบุ
PERSONAL บัญชีผู้ใช้ปลายทาง
LOCATION_GROUP กลุ่มสถานที่ตั้ง ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
USER_GROUP กลุ่มผู้ใช้สำหรับแยกเจ้าหน้าที่ขององค์กรเป็นกลุ่ม ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ
ORGANIZATION องค์กรที่เป็นตัวแทนของบริษัท ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ

AdWordsLocationExtensions

ข้อมูลเพิ่มเติมที่แสดงใน AdWords

ช่อง
ad_phone

string

หมายเลขโทรศัพท์สำรองที่จะแสดงในส่วนขยายสถานที่ตั้งของ AdWords แทนที่จะเป็นหมายเลขโทรศัพท์หลักของสถานที่ตั้ง

AddressInput

ข้อมูลที่ป้อนสำหรับการยืนยัน ADDRESS

ช่อง
mailer_contact_name

string

ชื่อผู้ติดต่อที่อีเมลควรส่งถึง

ผู้ดูแลระบบ

ผู้ดูแลระบบของ Account หรือ Location

ช่อง
name

string

ชื่อทรัพยากร สำหรับผู้ดูแลบัญชี ข้อมูลนี้จะอยู่ในรูป: accounts/{account_id}/admins/{admin_id}

สำหรับผู้ดูแลระบบสถานที่ตั้ง ข้อมูลนี้จะอยู่ในรูป: accounts/{account_id}/locations/{location_id}/admins/{admin_id}

admin_name

string

ชื่อของผู้ดูแลระบบ เมื่อสร้างคำเชิญครั้งแรก นี่คืออีเมลของผู้ได้รับเชิญ ในการโทรของ GET ระบบจะแสดงผลอีเมลของผู้ใช้หากคำเชิญยังรอดำเนินการอยู่ หรือไม่ก็จะมีชื่อและนามสกุลของผู้ใช้

role

AdminRole

ระบุ AdminRole ที่ผู้ดูแลระบบรายนี้ใช้กับทรัพยากร Account หรือ Location ที่ระบุ

pending_invitation

bool

เอาต์พุตเท่านั้น ระบุว่าผู้ดูแลระบบรายนี้มีคำเชิญที่รอดำเนินการสำหรับทรัพยากรที่ระบุหรือไม่

AdminRole

ระบุระดับการเข้าถึงที่ผู้ดูแลระบบมี ดูข้อมูลเพิ่มเติมได้ที่บทความในศูนย์ช่วยเหลือ

Enum
ADMIN_ROLE_UNSPECIFIED ไม่ได้ระบุ
OWNER ผู้ดูแลระบบมีสิทธิ์เข้าถึงระดับเจ้าของและเป็นเจ้าของหลัก (แสดงเป็น "เจ้าของหลัก" ใน UI)
CO_OWNER ผู้ดูแลระบบมีสิทธิ์เข้าถึงระดับเจ้าของ (แสดงเป็น "เจ้าของ" ใน UI)
MANAGER ผู้ดูแลระบบมีสิทธิ์เข้าถึงระดับผู้จัดการ
COMMUNITY_MANAGER ผู้ดูแลระบบสามารถจัดการหน้าโซเชียล (Google+) ได้ (แสดงเป็น "Site Manager" ใน UI)

AlertType

ประเภทเหตุการณ์ที่มีการสร้างโพสต์การแจ้งเตือน

Enum
ALERT_TYPE_UNSPECIFIED ไม่ได้ระบุการแจ้งเตือน
COVID_19 การแจ้งเตือนที่เกี่ยวข้องกับการแพร่ระบาดของโรคติดเชื้อไวรัสโคโรนา 2019 โพสต์โควิดรองรับเฉพาะช่องสรุปและช่องคำกระตุ้นให้ดำเนินการ (Call-To-Action) เมื่อการแจ้งเตือนเหล่านี้ไม่เกี่ยวข้องแล้ว ระบบจะปิดใช้การสร้างโพสต์การแจ้งเตือนใหม่สำหรับประเภทโควิด-19 แต่ผู้ขายจะยังจัดการโพสต์โควิด-19 ที่มีอยู่ได้

สารก่อภูมิแพ้

ข้อมูลสำหรับผู้แพ้อาหารที่เกี่ยวข้องกับอาหาร

Enum
ALLERGEN_UNSPECIFIED ไม่มีการระบุสารก่อภูมิแพ้
DAIRY สารก่อภูมิแพ้ที่เกี่ยวข้องกับนม
EGG สารก่อภูมิแพ้จากไข่
FISH สารก่อภูมิแพ้เกี่ยวกับปลา
PEANUT สารก่อภูมิแพ้จากถั่วลิสง
SHELLFISH สารก่อภูมิแพ้จากหอย
SOY สารก่อภูมิแพ้จากถั่วเหลือง
TREE_NUT สารก่อภูมิแพ้จากถั่วจากพืชยืนต้น
WHEAT สารก่อภูมิแพ้จากข้าวสาลี

คำตอบ

แสดงคำตอบสำหรับคำถาม

ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อที่ไม่ซ้ำกันสำหรับบัญชีคำตอบ/*/locations/*/questions/*/answers/*

author

Author

เอาต์พุตเท่านั้น ผู้เขียนคำตอบ

upvote_count

int32

เอาต์พุตเท่านั้น จํานวนการโหวตเห็นด้วยสําหรับคําตอบ

text

string

ข้อความของคำตอบ ควรมีอักขระที่ไม่ใช่ช่องว่างอย่างน้อย 1 ตัว โดยมีความยาวสูงสุด 4,096 อักขระ

create_time

Timestamp

เอาต์พุตเท่านั้น การประทับเวลาที่เขียนคำตอบ

update_time

Timestamp

เอาต์พุตเท่านั้น การประทับเวลาที่แก้ไขคำตอบครั้งล่าสุด

AssociateLocationRequest

ข้อความคำขอสำหรับ Locations.AssociateLocationRequest

ช่อง
name

string

ชื่อทรัพยากรของตำแหน่งที่จะเชื่อมโยง

place_id

string

สมาคมที่จะก่อตั้ง หากไม่ได้ตั้งค่า ระบบจะระบุว่าไม่มีรายการที่ตรงกัน

แอตทริบิวต์

แอตทริบิวต์ตำแหน่ง แอตทริบิวต์ให้ข้อมูลเพิ่มเติมเกี่ยวกับสถานที่ตั้ง แอตทริบิวต์ที่ตั้งค่าให้กับสถานที่ตั้งได้อาจแตกต่างกันไปตามพร็อพเพอร์ตี้ของสถานที่ตั้งนั้น (เช่น หมวดหมู่) Google จะเป็นผู้พิจารณาแอตทริบิวต์ที่พร้อมใช้งาน โดยอาจเพิ่มและนำออกได้โดยไม่ต้องเปลี่ยนแปลง API

ช่อง
attribute_id

string

รหัสของแอตทริบิวต์ รหัสแอตทริบิวต์มาจาก Google

value_type

AttributeValueType

เอาต์พุตเท่านั้น ประเภทของค่าที่มีในแอตทริบิวต์นี้ ข้อมูลนี้ควรใช้เพื่อระบุวิธีตีความค่า

values[]

Value

ค่าสำหรับแอตทริบิวต์นี้ ประเภทของค่าที่ระบุต้องตรงกับที่คาดไว้สำหรับแอตทริบิวต์นั้น ดู AttributeValueType นี่คือฟิลด์ที่ซ้ำได้ซึ่งสามารถระบุค่าแอตทริบิวต์ได้หลายรายการ ประเภทแอตทริบิวต์รองรับเพียงค่าเดียวเท่านั้น

repeated_enum_value

RepeatedEnumAttributeValue

เมื่อประเภทค่าแอตทริบิวต์เป็น REPEATED_ENUM ค่าจะมีค่าแอตทริบิวต์ และช่องค่าอื่นๆ ต้องว่างเปล่า

url_values[]

UrlAttributeValue

เมื่อประเภทค่าแอตทริบิวต์คือ URL ช่องนี้จะมีค่าของแอตทริบิวต์นี้ และฟิลด์ค่าอื่นๆ ต้องว่างเปล่า

AttributeMetadata

ข้อมูลเมตาสำหรับแอตทริบิวต์ มีข้อมูลที่แสดงสำหรับแอตทริบิวต์ ซึ่งรวมถึงชื่อที่แปลแล้วและส่วนหัวสำหรับจัดกลุ่มแอตทริบิวต์ที่เกี่ยวข้องไว้ด้วยกัน

ช่อง
attribute_id

string

รหัสของแอตทริบิวต์

value_type

AttributeValueType

ประเภทค่าของแอตทริบิวต์ ค่าที่กำหนดและดึงมาควรเป็นค่าประเภทนี้

display_name

string

ชื่อที่แสดงที่แปลแล้วของแอตทริบิวต์ (หากมี) ไม่เช่นนั้นจะใช้ชื่อที่แสดงเป็นภาษาอังกฤษ

group_display_name

string

ชื่อที่แสดงซึ่งแปลเป็นภาษาท้องถิ่นของกลุ่มที่มีแอตทริบิวต์นี้ (หากมี) หรือไม่เช่นนั้น จะใช้ชื่อกลุ่มภาษาอังกฤษ แอตทริบิวต์ที่เกี่ยวข้องจะรวบรวมเป็นกลุ่มและควรแสดงรวมกันภายใต้ส่วนหัวที่ระบุไว้ที่นี่

is_repeatable

bool

หากเป็น "จริง" แอตทริบิวต์จะรองรับหลายค่า หากเป็น "เท็จ" ควรระบุเพียงค่าเดียว

value_metadata[]

AttributeValueMetadata

สำหรับแอตทริบิวต์บางประเภท (เช่น enum) จะมีการแสดงรายการค่าที่รองรับและชื่อที่แสดงที่เกี่ยวข้องสำหรับค่าเหล่านั้น

is_deprecated

bool

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

AttributeValueMetadata

ข้อมูลเมตาสำหรับค่าแอตทริบิวต์ที่รองรับ

ช่อง
value

Value

ค่าแอตทริบิวต์

display_name

string

ชื่อที่แสดงสำหรับค่านี้ (หากมี) หรือไม่เช่นนั้น ให้เป็นภาษาอังกฤษ ชื่อที่แสดงของค่ามีไว้เพื่อใช้ในบริบทของชื่อที่แสดงของแอตทริบิวต์

เช่น สำหรับ "Wi-Fi" enum ของแอตทริบิวต์ ซึ่งอาจมี "Paid" เพื่อแสดง Wi-Fi แบบชำระเงิน

AttributeValueType

ประเภทค่าของแอตทริบิวต์

Enum
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED ไม่ได้ระบุ
BOOL ค่าสำหรับแอตทริบิวต์นี้เป็นค่าบูลีน
ENUM แอตทริบิวต์มีรายการค่าที่กำหนดไว้ล่วงหน้าของค่าที่ใช้ได้ ข้อมูลเมตาสำหรับแอตทริบิวต์นี้จะแสดงรายการค่าเหล่านี้
URL ค่าสำหรับแอตทริบิวต์นี้คือ URL
REPEATED_ENUM ค่าแอตทริบิวต์เป็น enum ที่มีหลายค่าที่เป็นไปได้ซึ่งตั้งค่าอย่างชัดเจนหรือไม่ตั้งค่าได้

ผู้เขียน

แสดงถึงผู้เขียนคำถามหรือคำตอบ

ช่อง
display_name

string

ชื่อที่แสดงของผู้ใช้

profile_photo_url

string

URL รูปโปรไฟล์ของผู้ใช้

type

AuthorType

ประเภทผู้ใช้ที่เป็นผู้เขียน

AuthorType

Enum สำหรับประเภทผู้ใช้ที่เป็นผู้เขียน

Enum
AUTHOR_TYPE_UNSPECIFIED ไม่ควรใช้
REGULAR_USER ผู้ใช้ทั่วไป
LOCAL_GUIDE Local Guide
MERCHANT เจ้าของ/ผู้จัดการของสถานที่

BasicMetricsRequest

คำขอข้อมูลเชิงลึกเกี่ยวกับเมตริกพื้นฐาน

ช่อง
metric_requests[]

MetricRequest

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

time_range

TimeRange

ช่วงที่จะรวบรวมเมตริก ระยะเวลาสูงสุดคือ 18 เดือนนับจากวันที่ส่งคำขอ ในบางกรณี ข้อมูลดังกล่าวอาจยังไม่หายไปสำหรับวันที่ใกล้กับวันที่ส่งคำขอ ระบบจะระบุข้อมูลที่ขาดหายไปใน metricValues ในการตอบกลับ

BatchGetBusinessCategoriesRequest

ข้อความคำขอสำหรับ BusinessCategory.BatchGetBusinessCategory

ช่อง
language_code

string

ต้องระบุ รหัส BCP 47 ของภาษาที่ควรแสดงผลชื่อหมวดหมู่

category_ids[]

string

ต้องระบุ ต้องตั้งชื่ออย่างน้อยหนึ่งชื่อ รหัส GConcept ที่ควรแสดงผลชื่อหมวดหมู่ที่แปลแล้ว

region_code

string

ไม่บังคับ รหัสประเทศ ISO 3166-1 alpha-2 ที่ใช้อนุมานภาษาที่ไม่ใช่มาตรฐาน

view

CategoryView

ต้องระบุ ระบุว่าควรแสดงผลส่วนใดของทรัพยากรหมวดหมู่ในการตอบกลับ

BatchGetBusinessCategoriesResponse

ข้อความตอบกลับสำหรับ BusinessCategory.BatchGetBusinessCategory

ช่อง
categories[]

Category

หมวดหมู่ที่ตรงกับรหัส GConcept ที่ระบุไว้ในคำขอ ซึ่งจะไม่เรียงตามลำดับเดียวกันกับรหัสหมวดหมู่ในคำขอ

BatchGetLocationsRequest

ข้อความคำขอสำหรับ Locations.BatchGetLocations

ช่อง
name

string

ชื่อบัญชีที่จะดึงข้อมูลสถานที่

location_names[]

string

คอลเล็กชันของสถานที่ตั้งที่จะดึงข้อมูล โดยระบุตามชื่อ

BatchGetLocationsResponse

ข้อความตอบกลับสำหรับ Locations.BatchGetLocations

ช่อง
locations[]

Location

คอลเล็กชันของสถานที่ตั้ง

BatchGetReviewsRequest

ข้อความคำขอสำหรับ Reviews.BatchGetReviews

ช่อง
name

string

ชื่อบัญชีที่ต้องการใช้เรียกดูรายการรีวิวในสถานที่ต่างๆ

location_names[]

string

คอลเล็กชันของสถานที่ตั้งที่จะดึงข้อมูลรีวิว โดยระบุชื่อสถานที่

page_size

int32

จำนวนรีวิวที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 50

page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลรีวิวหน้าถัดไป

order_by

string

ไม่บังคับ ระบุช่องเพื่อจัดเรียงรีวิว หากไม่ระบุ ลำดับของรีวิวที่ส่งคืนจะมีค่าเริ่มต้นเป็น update_time desc คำสั่งซื้อที่ถูกต้องที่สามารถจัดเรียงได้คือ rating, rating desc และ update_time desc rating จะส่งคืนรีวิวตามลำดับจากน้อยไปมาก ไม่รองรับ update_time(เช่น ตามลำดับจากน้อยไปมาก)

ignore_rating_only_reviews

bool

เลือกว่าจะไม่สนใจรีวิวที่เป็นการให้คะแนนเท่านั้นหรือไม่

BatchGetReviewsResponse

ข้อความตอบกลับสำหรับ Reviews.BatchGetReviews

ช่อง
location_reviews[]

LocationReview

รีวิวที่มีข้อมูลสถานที่ตั้ง

next_page_token

string

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

BusinessHours

แสดงระยะเวลาที่สถานที่นี้เปิดทำการอยู่ เก็บคอลเล็กชันของอินสแตนซ์ TimePeriod รายการ

ช่อง
periods[]

TimePeriod

จำนวนครั้งที่สถานที่นี้เปิดทำการ แต่ละช่วงเวลาแสดงช่วงเวลาซึ่งสถานที่เปิดทำการในระหว่างสัปดาห์

CallToAction

การดำเนินการที่เกิดขึ้นเมื่อผู้ใช้คลิกผ่านโพสต์

ช่อง
action_type

ActionType

ประเภทของการดำเนินการที่จะกระทำ

url

string

URL ที่ผู้ใช้จะไปถึงเมื่อคลิก ควรไม่ได้ตั้งค่าช่องนี้สำหรับ CTA การโทร

ActionType

ประเภทของการดำเนินการที่จะกระทำ

Enum
ACTION_TYPE_UNSPECIFIED ยังไม่ระบุประเภท
BOOK โพสต์นี้ต้องการให้ผู้ใช้จองการนัดหมาย/โต๊ะ/อื่นๆ
ORDER โพสต์นี้ต้องการให้ผู้ใช้สั่งอาหาร
SHOP โพสต์นี้ต้องการให้ผู้ใช้เรียกดูแคตตาล็อกผลิตภัณฑ์
LEARN_MORE โพสต์นี้ต้องการให้ผู้ใช้ดูข้อมูลเพิ่มเติม (ในเว็บไซต์ของผู้ใช้)
SIGN_UP โพสต์นี้ต้องการให้ผู้ใช้ลงทะเบียน/ลงชื่อสมัครใช้/เข้าร่วมบางสิ่งบางอย่าง
GET_OFFER

เลิกใช้งานแล้ว ใช้ OFFER ใน LocalPostTopicType เพื่อสร้างโพสต์ที่มีเนื้อหาข้อเสนอ

CALL โพสต์นี้ต้องการให้ผู้ใช้โทรหาธุรกิจ

หมวดหมู่

หมวดหมู่ที่อธิบายว่าธุรกิจนี้คืออะไร (ไม่ใช่สิ่งที่ทำ) ดูรายการรหัสหมวดหมู่ที่ถูกต้องและการแมปกับชื่อที่มนุษย์อ่านได้ที่หัวข้อ categories.list

ช่อง
display_name

string

ที่ใช้เวลาเพียง 2 นาที ชื่อหมวดหมู่ที่มนุษย์อ่านได้ ระบบจะตั้งค่านี้เมื่ออ่านตำแหน่ง ขณะแก้ไขสถานที่ตั้ง คุณต้องตั้งค่า category_id

หมายเหตุ: ช่องนี้ใช้ในคำตอบเท่านั้น ระบบจะไม่สนใจค่าที่ระบุไว้ในคำขอ

category_id

string

ที่ใช้เวลาเพียง 2 นาที รหัสแบบคงที่ (ระบุโดย Google) สำหรับหมวดหมู่นี้ ต้องระบุ category_id เมื่อแก้ไขหมวดหมู่ (เมื่อสร้างหรืออัปเดตสถานที่ตั้ง)

หมายเหตุ: ช่องนี้ใช้ในคำตอบเท่านั้น ระบบจะไม่สนใจค่าที่ระบุไว้ในคำขอ

service_types[]

ServiceType

ที่ใช้เวลาเพียง 2 นาที รายการบริการทุกประเภทที่ใช้ได้กับหมวดหมู่ธุรกิจนี้

หมายเหตุ: ช่องนี้ใช้ในคำตอบเท่านั้น ระบบจะไม่สนใจค่าที่ระบุไว้ในคำขอ

more_hours_types[]

MoreHoursType

เอาต์พุตเท่านั้น ประเภทเวลาทำการเพิ่มเติมที่ใช้ได้กับหมวดหมู่ธุรกิจนี้

CategoryView

Enum ที่จะช่วยจำกัดจำนวนข้อมูลที่เซิร์ฟเวอร์ส่งคืน

Enum
CATEGORY_VIEW_UNSPECIFIED ไม่ได้ระบุ เทียบเท่ากับ CATEGORY_METADATA_ONLY
BASIC การตอบกลับของเซิร์ฟเวอร์จะรวมเฉพาะช่อง Category_display_name, category_id และ language_code โดยไม่ใส่ช่องที่เกี่ยวข้องกับข้อมูลเมตาของบริการ
FULL แสดงช่องทั้งหมดในคำตอบ

โซ่

เครือคือแบรนด์ที่เชื่อมโยงกับสถานที่ตั้งของธุรกิจ

ช่อง
name

string

ชื่อทรัพยากรของเชนในรูปแบบ chains/{chain_place_id}

chain_names[]

ChainName

ชื่อของเชนธุรกิจ

websites[]

ChainUrl

เว็บไซต์ของเครือธุรกิจ

location_count

int32

จำนวนสถานที่ตั้งที่เป็นส่วนหนึ่งของเครือธุรกิจนี้

ChainName

ชื่อที่จะใช้เมื่อแสดงเชน

ช่อง
display_name

string

ชื่อที่แสดงของเชนนี้

language_code

string

รหัส BCP 47 ของภาษาของชื่อ

ChainUrl

URL ที่จะใช้เมื่อแสดงเชนธุรกิจ

ช่อง
url

string

URL ของเชนนี้

ClearLocationAssociationRequest

ข้อความคำขอสำหรับ Locations.ClearLocationAssociationRequest

ช่อง
name

string

ชื่อทรัพยากรของตำแหน่งที่จะยกเลิกการเชื่อมโยง

CompleteVerificationRequest

ข้อความขอ Verifications.CompleteConfirmAction

ช่อง
name

string

ชื่อแหล่งข้อมูลของการยืนยันที่จะดำเนินการให้เสร็จสมบูรณ์

pin

string

รหัส PIN ที่ผู้ขายได้รับเพื่อดำเนินการยืนยันให้เสร็จสมบูรณ์

CompleteVerificationResponse

ข้อความตอบกลับสำหรับ Verifications.Complete VerificationAction

ช่อง
verification

Verification

การยืนยันที่เสร็จสมบูรณ์แล้ว

CreateAccountAdminRequest

ข้อความคำขอ AccessControl.CreateAccountAdmin

ช่อง
parent

string

ชื่อทรัพยากรของบัญชีที่ผู้ดูแลระบบรายนี้สร้างขึ้น

admin

Admin

ผู้ดูแลระบบที่จะสร้าง

CreateAccountRequest

ข้อความคำขอสำหรับ Accounts.CreateAccount

ช่อง
primary_owner

string

ชื่อทรัพยากรของบัญชีที่จะเป็นเจ้าของหลักของบัญชีที่กำลังสร้าง ซึ่งควรอยู่ในรูปแบบ accounts/{account_id}/

account

Account

ข้อมูลบัญชีสำหรับบัญชีที่จะสร้าง ช่องที่อนุญาตมีเพียง account_name และประเภท

CreateLocalPostRequest

ข้อความคำขอสำหรับ CreateLocalPost

ช่อง
parent

string

ชื่อสถานที่ที่จะสร้างโพสต์ในพื้นที่นี้

local_post

LocalPost

ข้อมูลเมตาของโพสต์ใหม่ในเครื่อง

CreateLocationAdminRequest

ข้อความคำขอสำหรับ AccessControl.CreateLocationAdmin

ช่อง
parent

string

ชื่อทรัพยากรของตำแหน่งที่ผู้ดูแลระบบนี้สร้างให้

admin

Admin

ผู้ดูแลระบบที่จะสร้าง

CreateLocationRequest

ข้อความคำขอสำหรับ Locations.CreateLocation

ช่อง
parent

string

ชื่อบัญชีที่ใช้สร้างสถานที่ตั้งนี้

location

Location

ข้อมูลเมตาตำแหน่งใหม่

validate_only

bool

หากจริง ระบบจะตรวจสอบคำขอโดยไม่สร้างสถานที่ตั้งจริง

request_id

string

รหัสคำขอที่ไม่ซ้ำกันเพื่อให้เซิร์ฟเวอร์ตรวจหาคำขอที่ซ้ำกัน เราขอแนะนําให้ใช้ UUID ความยาวสูงสุด 50 อักขระ

CreateMediaItemRequest

ข้อความคำขอสำหรับ Media.CreateMediaItem

ช่อง
parent

string

ชื่อทรัพยากรของตำแหน่งที่จะสร้างรายการสื่อนี้

media_item

MediaItem

รายการสื่อที่จะสร้าง

CreateQuestionRequest

ข้อความคำขอสำหรับ QuestionsAndAnswers.CreateQuestion

ช่อง
parent

string

ชื่อสถานที่ที่ต้องการเขียนคำถาม

question

Question

คำถามใหม่นะ

DeclineInvitationRequest

ขอข้อความสำหรับ AccessControl.RejectedInvite

ช่อง
name

string

ชื่อของคำเชิญบัญชีที่ถูกปฏิเสธ

DeleteAccountAdminRequest

ข้อความขอ AccessControl.DeleteAccountAdmin

ช่อง
name

string

ชื่อทรัพยากรของผู้ดูแลระบบที่จะนำออกจากบัญชี

DeleteAnswerRequest

ข้อความคำขอสำหรับ QuestionsAndAnswers.DeleteAnswer

ช่อง
parent

string

ชื่อของคำถามที่ต้องการลบคำตอบ

DeleteLocalPostRequest

ข้อความคำขอสำหรับ DeleteLocalPost

ช่อง
name

string

ชื่อโพสต์ในเครื่องที่จะลบ

DeleteLocationAdminRequest

ข้อความขอ AccessControl.DeleteLocationAdmin

ช่อง
name

string

ชื่อทรัพยากรของผู้ดูแลระบบที่จะนำออกจากตำแหน่ง

DeleteLocationRequest

ข้อความคำขอสำหรับ Locations.DeleteLocation

ช่อง
name

string

ชื่อของสถานที่ที่จะลบ

DeleteMediaItemRequest

ข้อความคำขอสำหรับ Media.DeleteMediaItem

ช่อง
name

string

ชื่อรายการสื่อที่จะลบ

DeleteNotificationsRequest

ข้อความคำขอสำหรับ Accounts.DeleteNotifications

ช่อง
name

string

ชื่อทรัพยากรสำหรับการตั้งค่าการแจ้งเตือนที่จะล้าง

DeleteQuestionRequest

ข้อความคำขอสำหรับ QuestionsAndAnswers.DeleteQuestion

ช่อง
name

string

ชื่อของคำถามที่จะลบ

DeleteReviewReplyRequest

ข้อความคำขอสำหรับ Reviews.DeleteReviewAnswer

ช่อง
name

string

ชื่อของรีวิวที่ตอบกลับเพื่อลบ

DietaryRestriction

ข้อมูลอาหารของรายการอาหาร

Enum
DIETARY_RESTRICTION_UNSPECIFIED ไม่ได้ระบุประเภทอาหาร
HALAL สื่อถึงอาหารว่าเป็นอาหารฮาลาล
KOSHER สื่อถึงอาหารว่าเป็นอาหารโคเชอร์
ORGANIC สื่อถึงอาหารว่าเป็นอาหารออร์แกนิก
VEGAN สื่อถึงอาหารว่าเป็นอาหารวีแกน
VEGETARIAN การสื่อถึงอาหารว่าเป็นอาหารมังสวิรัติ

DimensionalMetricValue

ค่าสำหรับเมตริกเดียวพร้อมกับมิติข้อมูลเวลาหนึ่งๆ

ช่อง
metric_option

MetricOption

ตัวเลือกที่ขอค่ามิติข้อมูลนี้

time_dimension

TimeDimension

มิติข้อมูลสำหรับค่า

value

Int64Value

ค่า หากไม่ได้ตั้งค่าไว้ ข้อมูลที่ขอจะหายไป

TimeDimension

มิติข้อมูลที่มีการแบ่งข้อมูล

ช่อง
day_of_week

DayOfWeek

วันของสัปดาห์ ("MONDAY" ถึง "SUNDAY") ค่านี้สอดคล้องกับค่านี้ ตั้งค่าไว้สำหรับตัวเลือก BREAKDOWN_DAY_OF_WEEK

time_of_day

TimeOfDay

ชั่วโมงของวัน (0 ถึง 23) ที่ค่านี้สอดคล้อง ตั้งสำหรับตัวเลือก BREAKDOWN_HOUR_OF_DAY

time_range

TimeRange

ช่วงเวลาที่ค่านี้ครอบคลุม ตั้งค่าสำหรับตัวเลือก AGGREGATED_TOTAL และ AGGREGATED_DAILY

DrivingDirectionMetricsRequest

คำขอข้อมูลเชิงลึกเกี่ยวกับเส้นทางการขับขี่

ช่อง
num_days

NumDays

จำนวนวันในการรวบรวมข้อมูล ผลลัพธ์ที่ส่งกลับมาจะมีข้อมูลในช่วงจำนวนวันที่ขอล่าสุด ค่าที่ใช้ได้คือ 7, 30 และ 90

language_code

string

รหัส BCP 47 สำหรับภาษา หากไม่ได้ระบุรหัสภาษา จะใช้ภาษาอังกฤษเป็นค่าเริ่มต้น

NumDays

จํานวนวันที่คำขอนี้รองรับได้

Enum
SEVEN 7 วัน นี่คือค่าเริ่มต้น
THIRTY 30 วัน
NINETY 90 วัน

EmailInput

อินพุตสำหรับการยืนยัน EMAIL

ช่อง
email_address

string

ที่อยู่อีเมลปลายทางสำหรับส่ง PIN

เราจะยอมรับอีเมลก็ต่อเมื่อเป็นหนึ่งในที่อยู่ที่ FetchConfirmOptions ระบุเท่านั้น หาก EmailVerificationData ตั้งค่า is_user_name_edit เป็นจริง ไคลเอ็นต์อาจระบุชื่อผู้ใช้อื่น (local-part) แต่ต้องตรงกับชื่อโดเมน

ErrorDetail

ระบุรายละเอียดข้อผิดพลาดที่ส่งผลให้มีการตรวจสอบความถูกต้องหรือความล้มเหลวภายใน

ช่อง
code

int32

รหัสสถานะ ซึ่งควรเป็นค่า enum ของ ErrorCode

field

string

เส้นทางที่นำไปยังช่องในเนื้อหาคำขอ ค่านี้คือลำดับของตัวระบุที่คั่นด้วยจุดซึ่งระบุช่องบัฟเฟอร์โปรโตคอล เช่น "error_details.field" จะระบุฟิลด์นี้ได้

message

string

คำอธิบายว่าเหตุใดช่องนี้จึงดำเนินการไม่สำเร็จ ข้อความเป็นภาษาอังกฤษและอาจไม่เหมาะสมที่จะแสดงต่อผู้ใช้

value

string

ค่าที่ดำเนินการตามคำขอไม่สำเร็จ

field_index

int32

หากช่องคำขอที่สร้างข้อผิดพลาดนี้เกิดขึ้นซ้ำ ช่องนั้นจะมีดัชนีฐาน 0 ของรายการในช่องนั้น ซึ่งทำให้การตรวจสอบล้มเหลว

ErrorCode

รหัสข้อผิดพลาดสำหรับ ErrorDetail:

  • 1 ถึง 199: รหัสข้อผิดพลาดที่พบบ่อยซึ่งใช้ได้กับทุกช่อง
  • 1000 ถึง 1099: รหัสข้อผิดพลาดเกี่ยวกับรูปภาพ
  • 1100 ถึง 1199: รหัสข้อผิดพลาดเกี่ยวกับที่อยู่และละติจูด/ลองจิจูด
  • 1200 ถึง 1299: รหัสข้อผิดพลาดที่เกี่ยวข้องกับหมวดหมู่
  • 1300 ถึง 1399: รหัสข้อผิดพลาดเกี่ยวกับการดำเนินการ

Enum
ERROR_CODE_UNSPECIFIED รหัสข้อผิดพลาดที่รับทั้งหมด
MISSING_VALUE ไม่ได้ระบุค่าที่จำเป็น
INVALID_VALUE ระบุค่าไม่ถูกต้อง
INVALID_CHARACTERS พบอักขระที่ไม่ถูกต้อง
TOO_MANY_ITEMS ระบุรายการในช่องที่ซ้ำเกินจำนวนสูงสุด
READ_ONLY ไม่สามารถแก้ไขฟิลด์แบบอ่านอย่างเดียว
OVERLAPPING_RANGES รายการในฟิลด์ที่ซ้ำคือช่วงที่ซ้อนทับกันเอง
INVERTED_RANGE ช่วงที่ระบุจะกลับด้าน โดยจะรวมถึงกรณีของช่วงว่างด้วย
VALUE_OUTSIDE_ALLOWED_RANGE ค่าที่ระบุอยู่นอกช่วงที่อนุญาต
MISSING_DEPENDENT_FIELD ไม่มีฟิลด์ที่ต้องพึ่งพา
FIELD_HAS_DEPENDENCIES ต้องกรอกข้อมูลในช่องที่อ้างอิงกันและนำออกไม่ได้
UNSUPPORTED_VALUE ระบบไม่รองรับค่าที่ระบุเนื่องจากข้อจำกัดอื่นๆ แม้ว่าอาจจะถูกต้องก็ตาม
EXPIRED_VALUE ค่าที่ระบุหมดอายุแล้วและใช้ไม่ได้อีกต่อไป
PHOTO_FETCH_FAILED ไม่สามารถเรียกรูปภาพจาก URL ที่ระบุ
PHOTO_UPLOAD_FAILED อัปโหลดรูปภาพจาก URL ที่ระบุไม่สำเร็จ
GEOCODE_ERROR เกิดข้อผิดพลาดในการกำหนดละติจูด/ลองจิจูดโดยอัตโนมัติ
LAT_LNG_OUTSIDE_COUNTRY ละติจูด/ลองจิจูดที่ระบุไม่ได้อยู่ในประเทศที่ระบุ
LAT_LNG_REQUIRED ต้องระบุละติจูดและลองจิจูด
LAT_LNG_TOO_FAR_FROM_ADDRESS คู่ละติจูด/ลองจิจูดและที่อยู่ห่างกันเกินไป
CATEGORY_NOT_VERIFIED หมวดหมู่ที่ระบุไม่ได้รับการยืนยัน
OPERATION_EXECUTION_ERROR ข้อผิดพลาดทั่วไปของการดำเนินการเพื่อดำเนินการ
OPERATION_UNSUPPORTED_UNDER_ACCOUNT_CONDITION ไม่รองรับการดำเนินการนี้เนื่องจากเงื่อนไขของบัญชี
LOCATION_DISABLED_FOR_LOCAL_POST_API ปิดใช้ตำแหน่งสำหรับ Local Post API

FetchVerificationOptionsRequest

ข้อความขอ Verifications.Fetch VerificationOptions

ช่อง
name

string

ชื่อทรัพยากรของสถานที่ที่ยืนยัน

language_code

string

รหัสภาษา BCP 47 ซึ่งแสดงภาษาที่ใช้สำหรับกระบวนการยืนยัน ตัวเลือกที่มีจะแตกต่างกันไปตามภาษา

context

ServiceBusinessContext

ข้อมูลบริบทเพิ่มเติมสำหรับการยืนยันธุรกิจที่ให้บริการ ต้องระบุสำหรับสถานที่ที่มีประเภทธุรกิจคือ CUSTOMER_LOCATION_ONLY ระบบจะโยน INVALID_ARGUMENT ไปหากมีการตั้งค่าไว้สำหรับสถานที่ตั้งธุรกิจประเภทอื่น

FetchVerificationOptionsResponse

ข้อความตอบกลับสำหรับ Verifications.Fetch VerificationOptions

ช่อง
options[]

VerificationOption

ตัวเลือกการยืนยันที่มีให้

FindMatchingLocationsRequest

ข้อความคำขอสำหรับ Locations.FindMatchingLocations

ช่อง
name

string

ชื่อทรัพยากรของตำแหน่งที่จะค้นหารายการที่ตรงกัน

language_code

string

ภาษาที่ต้องการสำหรับตำแหน่งที่ตรงกัน (ในรูปแบบ BCP-47)

num_results

int32

จำนวนรายการที่ตรงกันที่จะส่งคืน ค่าเริ่มต้นคือ 3 แต่สูงสุด 10 รายการ โปรดทราบว่าเวลาในการตอบสนองอาจเพิ่มขึ้นหากมีการร้องขอเพิ่มเติม โดยไม่มีการใส่เลขหน้า

max_cache_duration

Duration

เลิกใช้งานแล้ว ระบบจะไม่พิจารณาช่องนี้สำหรับคำขอทั้งหมด

FindMatchingLocationsResponse

ข้อความตอบกลับสำหรับ Locations.FindMatchingLocations

ช่อง
matched_locations[]

MatchedLocation

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

match_time

Timestamp

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

FollowersMetadata

ข้อมูลเมตาของผู้ติดตามของสถานที่

ช่อง
name

string

ชื่อทรัพยากรสำหรับกรณีนี้ accounts/{account_id}/locations/{location_id}/followers/metadata

count

uint64

จำนวนผู้ติดตามทั้งหมดของสถานที่

FoodMenu

เมนูของธุรกิจที่ให้บริการอาหาร

ช่อง
labels[]

MenuLabel

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับเมนู เช่น "เมนู", "อาหารกลางวันมื้อพิเศษ" ชื่อที่แสดงควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 1,000 ตัว ต้องระบุป้ายกำกับอย่างน้อย 1 ชุด

source_url

string

ไม่บังคับ URL แหล่งที่มาของเมนู หากมีหน้าเว็บที่จะไป

sections[]

FoodMenuSection

ต้องระบุ ส่วนต่างๆ ของเมนู

cuisines[]

Cuisine

ไม่บังคับ ข้อมูลอาหารสำหรับเมนูอาหาร เราขอแนะนำอย่างยิ่งให้ระบุช่องนี้

สไตล์อาหาร

ข้อมูลด้านอาหารของร้านอาหาร

Enum
CUISINE_UNSPECIFIED ไม่ได้ระบุอาหาร
AMERICAN อาหารอเมริกัน
ASIAN อาหารเอเชีย
BRAZILIAN อาหารบราซิล
BREAK_FAST อาหารเช้า
BRUNCH อาหารมื้อสาย
CHICKEN ไก่
CHINESE อาหารจีน
FAMILY อาหารสไตล์ครอบครัว
FAST_FOOD ฟาสต์ฟู้ด
FRENCH อาหารฝรั่งเศส
GREEK อาหารกรีก
GERMAN อาหารเยอรมัน
HAMBURGER แฮมเบอร์เกอร์
INDIAN อาหารอินเดีย
INDONESIAN อาหารอินโดนีเซีย
ITALIAN อาหารอิตาลี
JAPANESE อาหารญี่ปุ่น
KOREAN อาหารเกาหลี
LATIN_AMERICAN อาหารละตินอเมริกา
MEDITERRANEAN อาหารเมดิเตอร์เรเนียน
MEXICAN อาหารเม็กซิโก
PAKISTANI อาหารปากีสถาน
PIZZA พิซซ่า
SEAFOOD อาหารทะเล
SPANISH อาหารสเปน
SUSHI ซูชิ
THAI อาหารไทย
TURKISH อาหารตุรกี
VEGETARIAN อาหารมังสวิรัติ
VIETNAMESE อาหารเวียดนาม
OTHER_CUISINE อาหารอื่นๆ

FoodMenuItem

รายการในส่วน โดยอาจเป็นอาหารจานนั้นหรือจะมี FoodMenuItemOption หลายรายการก็ได้

ช่อง
labels[]

MenuLabel

ต้องระบุ ป้ายกำกับภาษาที่ติดแท็กของรายการในเมนูนี้ ชื่อที่แสดงควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 1,000 ตัว ต้องระบุป้ายกำกับอย่างน้อย 1 ชุด

attributes

FoodMenuItemAttributes

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

options[]

FoodMenuItemOption

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

FoodMenuItemAttributes

แอตทริบิวต์ของรายการอาหาร/อาหาร

ช่อง
price

Money

ต้องระบุ ราคาอาหาร

spiciness

Spiciness

ไม่บังคับ ระดับความเผ็ดของอาหาร

allergen[]

Allergen

ไม่บังคับ สารก่อภูมิแพ้ที่เกี่ยวข้องกับอาหาร เราขอแนะนำอย่างยิ่งให้ระบุช่องนี้

dietary_restriction[]

DietaryRestriction

ไม่บังคับ ข้อมูลอาหารของอาหาร เราขอแนะนำอย่างยิ่งให้ระบุช่องนี้

nutrition_facts

NutritionFacts

ไม่บังคับ ข้อมูลโภชนาการของตัวเลือกอาหาร เราขอแนะนำอย่างยิ่งให้ระบุช่องนี้

ingredients[]

Ingredient

ไม่บังคับ ส่วนผสมของเมนูอาหารที่เลือก

serves_num_people

int32

ไม่บังคับ จำนวนคนที่ให้บริการด้วยตัวเลือกอาหารนี้

preparation_methods[]

PreparationMethod

ไม่บังคับ วิธีการจัดเตรียมตัวเลือกอาหาร

portion_size

PortionSize

ไม่บังคับ ขนาดของคำสั่งซื้อซึ่งแสดงเป็นหน่วยสินค้า (เช่น 4 "เสียบไม้", 6 "ชิ้น")

media_keys[]

string

ไม่บังคับ คีย์สื่อของสื่อที่เกี่ยวข้องกับอาหาร รองรับเฉพาะสื่อรูปภาพเท่านั้น เมื่อมีรูปภาพเชื่อมโยงอยู่หลายรูป ระบบจะถือว่ารูปภาพแรกเป็นรูปภาพที่ต้องการให้แสดง

ส่วนผสม

ข้อความนี้แสดงถึงข้อมูลส่วนผสมของอาหาร

ช่อง
labels[]

MenuLabel

ต้องระบุ ป้ายกำกับเพื่ออธิบายส่วนผสม ชื่อที่แสดงควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 1,000 ตัว ต้องระบุป้ายกำกับอย่างน้อย 1 ชุด

PortionSize

ขนาดส่วนของอาหาร 1 จาน

ช่อง
quantity

int32

ต้องระบุ จำนวนส่วน

unit[]

MenuLabel

ต้องระบุ ฟิลด์ name_info ที่ซ้ำกันมีไว้สำหรับหน่วยในหลายภาษา

FoodMenuItemOption

ตัวเลือกของสินค้า ต้องมีการเลือกโดยผู้ใช้อย่างชัดแจ้ง

ช่อง
labels[]

MenuLabel

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับตัวเลือกรายการในเมนูนี้ เช่น "ผัดไทย", "ผัดไทย", "พิซซ่าเล็ก", "พิซซ่าใหญ่" ชื่อที่แสดงควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 1,000 ตัว ต้องระบุป้ายกำกับอย่างน้อย 1 ชุด

attributes

FoodMenuItemAttributes

ต้องระบุ แอตทริบิวต์โดยละเอียดของตัวเลือกสินค้า แอตทริบิวต์แต่ละรายการที่ไม่ได้ระบุจะรับค่ามาจากแอตทริบิวต์ระดับสินค้าเป็นฐาน

FoodMenuSection

ส่วนเมนู สามารถมีหลายรายการ/อาหาร

ช่อง
labels[]

MenuLabel

ต้องระบุ ป้ายกำกับที่แท็กภาษาสำหรับส่วนเมนูนี้ ชื่อที่แสดงควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 1,000 ตัว ต้องระบุป้ายกำกับอย่างน้อย 1 ชุด

items[]

FoodMenuItem

ต้องระบุ รายการในส่วนนี้ แต่ละส่วนต้องมีอย่างน้อย 1 รายการ

FoodMenus

เมนูของธุรกิจที่ให้บริการอาหาร

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}/foodMenus

menus[]

FoodMenu

ไม่บังคับ คอลเล็กชันเมนูอาหาร

GenerateAccountNumberRequest

ข้อความคำขอสำหรับ Accounts.GenerateAccountNumber

ช่อง
name

string

ชื่อของบัญชีที่จะสร้างหมายเลขบัญชี

GetAccountRequest

ข้อความคำขอสำหรับ Accounts.GetAccount

ช่อง
name

string

ชื่อบัญชีที่จะดึงข้อมูล

GetChainRequest

ข้อความคำขอสำหรับ Locations.GetChain

ช่อง
name

string

ชื่อทรัพยากรของเชนในรูปแบบ chains/{chain_place_id}

GetCustomerMediaItemRequest

ข้อความคำขอสำหรับ Media.GetCustomerMediaItem

ช่อง
name

string

ชื่อทรัพยากรของรายการสื่อของลูกค้าที่ขอ

GetFollowersMetadataRequest

ขอข้อความขอข้อมูลเมตาของผู้ติดตามของสถานที่

ช่อง
name

string

ชื่อทรัพยากรของข้อมูลเมตาผู้ติดตามของสถานที่ accounts/{account_id}/locations/{location_id}/followers/metadata

GetFoodMenusRequest

ข้อความขอ FoodMenu.GetFoodMenus

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}/foodMenus

read_mask

FieldMask

ไม่บังคับ ช่องเฉพาะที่จะแสดงผล หากไม่ได้ระบุมาสก์ไว้ ระบบจะแสดงเมนูอาหารแบบเต็ม (เหมือนกับ "*") ระบุรายการช่องที่ซ้ำทีละรายการไม่ได้ เช่น "name" และ "เมนู" เป็นมาสก์ที่ถูกต้อง ขณะที่ "menus.sections" ไม่ถูกต้อง

GetHealthProviderAttributesRequest

ข้อความคำขอสำหรับ HealthProviderAttributes.GetHealthProviderAttributes

ช่อง
name

string

ต้องระบุ ตัวระบุ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}/healthProviderAttributes

language_code

string

ไม่บังคับ รหัส BCP 47 สำหรับภาษา หากไม่ได้ระบุรหัสภาษา จะใช้ภาษาอังกฤษเป็นค่าเริ่มต้น ขณะนี้มีเพียง "en" เท่านั้น ได้

GetLocalPostRequest

ขอข้อความสำหรับ LocalPOST.GetLocalPost

ช่อง
name

string

ชื่อโพสต์ในท้องถิ่นที่จะดึงข้อมูล

GetLocationRequest

ข้อความคำขอสำหรับ Locations.GetLocation

ช่อง
name

string

ชื่อของสถานที่ที่จะดึงข้อมูล

GetMediaItemRequest

ข้อความคำขอสำหรับ Media.GetMediaItem

ช่อง
name

string

ชื่อรายการสื่อที่ขอ

GetNotificationsRequest

ข้อความคำขอสำหรับ Accounts.GetNotifications

ช่อง
name

string

ชื่อทรัพยากรการตั้งค่าการแจ้งเตือน

GetReviewRequest

ข้อความส่งคำขอสำหรับ Reviews.GetReview

ช่อง
name

string

ชื่อของรีวิวที่จะดึงข้อมูล

GetServiceListRequest

รับข้อความคำขอรายการบริการ

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}/servicelist

GoogleLocation

แสดง Location ที่มีอยู่ใน Google ซึ่งอาจเป็นสถานที่ที่ถูกอ้างสิทธิ์โดยผู้ใช้ บุคคลอื่น หรืออาจถูกถอนการอ้างสิทธิ์

ช่อง
name

string

ชื่อทรัพยากรของ GoogleLocation นี้ในรูปแบบ googleLocations/{googleLocationId}

location

Location

ข้อมูล Location ที่มีการป้อนข้อมูลเล็กน้อย คุณใช้ช่องนี้ซ้ำได้ใน CreateLocation หากยังไม่ได้อ้างสิทธิ์จากผู้ใช้

request_admin_rights_url

string

URL ที่จะเปลี่ยนเส้นทางผู้ใช้ไปยัง UI ของคำขอสิทธิ์ของผู้ดูแลระบบ ช่องนี้จะปรากฏเฉพาะในกรณีที่มีผู้ใช้อ้างสิทธิ์ในสถานที่ดังกล่าวแล้ว รวมทั้งผู้ใช้ปัจจุบันด้วย

GoogleUpdatedLocation

แสดงสถานที่ที่ Google ปรับเปลี่ยน

ช่อง
location

Location

เวอร์ชันที่ Google อัปเดตของสถานที่นี้

diff_mask

FieldMask

ช่องที่ Google อัปเดต

HealthProviderAttributes

แอตทริบิวต์ของผู้ให้บริการด้านสุขภาพที่ลิงก์กับสถานที่ตั้งนี้

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}/healthProviderAttributes

insurance_networks[]

InsuranceNetwork

ไม่บังคับ รายชื่อเครือข่ายการประกันภัยที่เกิดขึ้นในสถานที่ตั้งนี้

InsuranceNetwork

เครือข่ายการประกันเดียว รหัสถัดไป: 5

ช่อง
network_id

string

ต้องระบุ รหัสของเครือข่ายการประกันนี้ที่ Google สร้างขึ้น

network_names

map<string, string>

เอาต์พุตเท่านั้น แผนที่ของชื่อที่แสดงของเครือข่ายในภาษาที่ขอซึ่งมีภาษาเป็นคีย์ และชื่อที่แสดงที่แปลแล้วคือค่า ชื่อที่แสดงเป็นภาษาอังกฤษได้รับการตั้งค่าโดยค่าเริ่มต้น

payer_names

map<string, string>

เอาต์พุตเท่านั้น แผนที่ชื่อที่แสดงของผู้ชำระเงินในภาษาที่ขอซึ่งมีภาษาเป็นคีย์ และชื่อที่แสดงที่แปลแล้วคือค่า ชื่อที่แสดงเป็นภาษาอังกฤษได้รับการตั้งค่าโดยค่าเริ่มต้น

state

NetworkState

เอาต์พุตเท่านั้น สถานะของเครือข่ายการประกันนี้

InternalError

อธิบายความล้มเหลวภายใน

ช่อง
error_details[]

ErrorDetail

ระบุรายละเอียดความล้มเหลวแต่ละรายการ

คำเชิญ

เอาต์พุตเท่านั้น แสดงคำเชิญที่รอดำเนินการ

ช่อง
name

string

ชื่อทรัพยากรสำหรับคำเชิญ

role

AdminRole

บทบาทที่ได้รับเชิญในบัญชี

ช่องการรวม target ระบุเป้าหมายของคำเชิญนี้ target ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
target_account

Account

บัญชีที่มีการป้อนข้อมูลเล็กน้อยสำหรับคำเชิญนี้

target_location

TargetLocation

สถานที่เป้าหมายในคำเชิญนี้

TargetLocation

แสดงสถานที่เป้าหมายสำหรับคำเชิญที่รอดำเนินการ

ช่อง
location_name

string

ชื่อของสถานที่ที่ผู้ใช้ได้รับเชิญ

location_address

string

ที่อยู่ของสถานที่ที่ผู้ใช้ได้รับเชิญ

ListAccountAdminsRequest

ข้อความคำขอสำหรับ AccessControl.ListAccountAdmins

ช่อง
parent

string

ชื่อบัญชีที่จะเรียกดูรายชื่อผู้ดูแลระบบ

ListAccountAdminsResponse

ข้อความตอบกลับสำหรับ AccessControl.ListAccountAdmins

ช่อง
admins[]

Admin

คอลเล็กชันของอินสแตนซ์ Admin รายการ

ListAccountsRequest

ข้อความคำขอสำหรับ Accounts.ListAccounts

ช่อง
page_size

int32

จำนวนบัญชีที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 20, ต่ำสุดคือ 2 และขนาดหน้าเว็บสูงสุดคือ 20

page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลหน้าถัดไปของบัญชี ระบบแสดงผล pageToken เมื่อการเรียก accounts.list แสดงผลลัพธ์มากเกินกว่าพอดีกับขนาดหน้าที่ร้องขอ

name

string

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

filter

string

ตัวกรองที่จำกัดบัญชีให้แสดงผลได้ การตอบกลับมีเฉพาะรายการที่ตรงกับตัวกรอง หาก filter ว่างเปล่า จะไม่มีการใช้ข้อจำกัดและจะดึงข้อมูลบัญชีทั้งหมด (ใส่เลขหน้า) สำหรับบัญชีที่ขอ

ตัวอย่างเช่น คำขอที่มีตัวกรอง type=USER_GROUP จะแสดงผลกลุ่มผู้ใช้เท่านั้น

ListAccountsResponse

ข้อความตอบกลับสำหรับ Accounts.ListAccounts.

ช่อง
accounts[]

Account

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

next_page_token

string

หากมีจำนวนบัญชีเกินขนาดหน้าเว็บที่ขอ ระบบจะเติมข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของบัญชีในการเรียก accounts.list ครั้งถัดไป หากไม่มีบัญชีเพิ่มเติม ช่องนี้จะไม่ปรากฏในคำตอบ

ListAnswersRequest

ข้อความคำขอสำหรับ QuestionsAndAnswers.ListAnswers

ช่อง
parent

string

ชื่อของคำถามที่จะดึงคำตอบ

page_size

int32

จำนวนคำตอบที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นและค่าสูงสุด page_size ค่าคือ 10

page_token

string

หากระบุไว้ ระบบจะเรียกดูคำตอบหน้าถัดไป

order_by

string

ลำดับการส่งคำตอบ ตัวเลือกที่ถูกต้องรวมถึง "update_time desc" และ "upvote_count desc" ซึ่งจะแสดงผลคำตอบที่จัดเรียงตามช่องที่ขอจากมากไปน้อย ลำดับการจัดเรียงเริ่มต้นคือ "update_time desc"

ListAnswersResponse

ข้อความตอบกลับสำหรับ QuestionsAndAnswers.ListAnswers

ช่อง
answers[]

Answer

คำตอบที่ขอ

total_size

int32

จำนวนคำตอบทั้งหมดที่โพสต์สำหรับคำถามนี้ในทุกหน้าเว็บ

next_page_token

string

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

ListAttributeMetadataRequest

ข้อความคำขอสำหรับ Locations.ListAttributeMetadata หากระบุชื่อทรัพยากรตำแหน่งแล้ว ระบบจะใช้ตำแหน่งนั้นเพื่อป้อนข้อมูลเกณฑ์ที่เหลือ หากไม่มี ให้ระบุหมวดหมู่และประเทศ

ช่อง
name

string

ชื่อทรัพยากรของตำแหน่งเพื่อค้นหาแอตทริบิวต์ที่พร้อมใช้งาน

category_id

string

รหัสแบบคงที่ของหมวดหมู่หลักสำหรับค้นหาแอตทริบิวต์ที่พร้อมใช้งาน

country

string

รหัสประเทศ ISO 3166-1 alpha-2 เพื่อค้นหาแอตทริบิวต์ที่ใช้ได้

language_code

string

รหัสภาษา BCP 47 ที่ใช้รับชื่อที่แสดงของแอตทริบิวต์ แต่หากไม่มีภาษาดังกล่าว ก็จะเป็นภาษาอังกฤษ

page_size

int32

จำนวนแอตทริบิวต์ที่จะใส่ใน 1 หน้า ค่าเริ่มต้นคือ 200 และต่ำสุดคือ 1

page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลหน้าถัดไปของข้อมูลเมตาของแอตทริบิวต์ ระบบแสดงผล pageToken เมื่อการเรียก attributes.list แสดงผลลัพธ์มากเกินกว่าพอดีกับขนาดหน้าที่ร้องขอ

ListAttributeMetadataResponse

ข้อความตอบกลับสำหรับ Locations.ListAttributeMetadata

ช่อง
attributes[]

AttributeMetadata

คอลเล็กชันข้อมูลเมตาของแอตทริบิวต์สำหรับแอตทริบิวต์ที่พร้อมใช้งาน

next_page_token

string

หากจำนวนแอตทริบิวต์เกินขนาดหน้าที่ขอ ระบบจะเติมข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลแอตทริบิวต์หน้าถัดไปในการเรียก attributes.list ครั้งถัดไป หากไม่มีแอตทริบิวต์อื่นเพิ่มเติม ระบบจะไม่แสดงช่องนี้ในการตอบกลับ

ListBusinessCategoriesRequest

ช่อง
region_code

string

รหัสประเทศ ISO 3166-1 alpha-2

language_code

string

รหัสภาษา BCP 47 หากภาษาไม่พร้อมใช้งาน ระบบจะใช้ภาษาอังกฤษเป็นค่าเริ่มต้น

search_term

string

สตริงตัวกรองที่ไม่บังคับจากผู้ใช้

page_size

int32

จำนวนหมวดหมู่ที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 100, ต่ำสุดคือ 1 และขนาดสูงสุดของหน้าเว็บคือ 100

page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลหมวดหมู่ถัดไป

view

CategoryView

ไม่บังคับ ระบุว่าควรแสดงผลส่วนใดของทรัพยากรหมวดหมู่ในการตอบกลับ

ListBusinessCategoriesResponse

ช่อง
categories[]

Category

หมวดหมู่ หมวดหมู่เป็นมุมมองพื้นฐาน โดยจะไม่มีข้อมูล ServiceType ใดๆ

total_category_count

int32

จำนวนหมวดหมู่ทั้งหมดของพารามิเตอร์คำขอ

next_page_token

string

หากมีหมวดหมู่เกินขนาดหน้าที่ขอ จะมีการเติมข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลหมวดหมู่หน้าถัดไปในการเรียก ListBusinessCategories ครั้งถัดไป

ListCustomerMediaItemsRequest

ข้อความคำขอสำหรับ Media.ListCustomerMediaItems

ช่อง
parent

string

ชื่อสถานที่ตั้งที่รายการสื่อของลูกค้าจะปรากฏ

page_size

int32

จำนวนรายการสื่อที่จะแสดงต่อ 1 หน้า ค่าเริ่มต้นคือ 100 ขนาดหน้าสูงสุดที่รองรับคือ 200

page_token

string

หากระบุไว้จะแสดงหน้าถัดไปของรายการสื่อ

ListCustomerMediaItemsResponse

ข้อความตอบกลับสำหรับ Media.ListCustomerMediaItems

ช่อง
media_items[]

MediaItem

รายชื่อสื่อที่แสดง

total_media_item_count

int32

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

next_page_token

string

หากมีรายการสื่อมากกว่าขนาดหน้าที่ขอ ช่องนี้จะมีการเติมข้อมูลด้วยโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของรายการสื่อในการเรียก ListCustomerMediaItems ที่ตามมา

ListInsuranceNetworksRequest

ข้อความคำขอสำหรับ InsuranceNetworkService.ListInsuranceNetworks

ช่อง
parent

string

ต้องระบุ ชื่อสถานที่ที่จะแสดงเครือข่ายการประกัน ชื่อต้องอยู่ในรูปแบบ: accounts/{account_id}/locations/{location_id}

language_code

string

ไม่บังคับ รหัส BCP 47 สำหรับภาษา หากไม่ได้ระบุรหัสภาษา จะใช้ภาษาอังกฤษเป็นค่าเริ่มต้น ขณะนี้มีเพียง "en" เท่านั้น ได้

page_size

int32

จำนวนเครือข่ายการประกันที่จะส่งคืนต่อหน้า ค่าเริ่มต้นคือ 5,000 ขนาดหน้าเว็บสูงสุดคือ 10,000

page_token

string

หากระบุไว้จะแสดงหน้าถัดไปของเครือข่ายการประกัน

ListInsuranceNetworksResponse

ข้อความตอบกลับสำหรับ InsuranceNetworkService.ListInsuranceNetworks

ช่อง
networks[]

InsuranceNetwork

รายการเครือข่ายการประกันที่ Google รองรับ

next_page_token

string

หากมีเครือข่ายการประกันมากกว่าขนาดหน้าเว็บที่ขอ ฟิลด์นี้จะมีโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของเครือข่ายการประกันในการเรียกใช้ ListInsuranceNetworks ในภายหลัง

ListInvitationsRequest

ขอข้อความสำหรับ AccessControl.ListInvites

ช่อง
parent

string

ชื่อบัญชีที่มีการดึงข้อมูลรายการคำเชิญ

target_type

TargetType

ระบุประเภทเป้าหมายที่ควรปรากฏในการตอบกลับ

TargetType

ประเภทของเป้าหมายที่จะได้รับคำเชิญ

Enum
ALL แสดงรายการคำเชิญสำหรับเป้าหมายทุกประเภท โดยตัวเลือกนี้คือค่าเริ่มต้น
ACCOUNTS_ONLY แสดงคำเชิญสำหรับเป้าหมายประเภท "บัญชี" เท่านั้น
LOCATIONS_ONLY แสดงคําเชิญสําหรับเป้าหมายประเภทสถานที่ตั้งเท่านั้น

ListInvitationsResponse

ข้อความตอบกลับสำหรับ AccessControl.ListInvites

ช่อง
invitations[]

Invitation

คอลเล็กชันของคำเชิญตามสถานที่ตั้งที่รอดำเนินการสำหรับบัญชี จำนวนคำเชิญที่แสดงที่นี่ต้องไม่เกิน 1,000 รายการ

ListLocalPostsRequest

ข้อความคำขอสำหรับ ListLocalPost

ช่อง
parent

string

ชื่อสถานที่ที่จะแสดงโพสต์ในพื้นที่

page_size

int32

จำนวนโพสต์ในพื้นที่ที่จะแสดงต่อ 1 หน้า ค่าเริ่มต้นคือ 20 ขนาดต่ำสุดคือ 1 และมีขนาดหน้าเว็บสูงสุดคือ 100

page_token

string

หากระบุไว้ ระบบจะแสดงหน้าถัดไปของโพสต์ในพื้นที่

ListLocalPostsResponse

ข้อความตอบกลับสำหรับ ListLocalPost

ช่อง
local_posts[]

LocalPost

รายการที่แสดงของโพสต์ในพื้นที่

next_page_token

string

หากมีโพสต์ในพื้นที่มากกว่าขนาดหน้าเว็บที่ขอ ข้อมูลในช่องนี้จะมีโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของโพสต์ในพื้นที่ในการเรียกไปยัง ListLocalPosts ในภายหลัง

ListLocationAdminsRequest

ข้อความคำขอสำหรับ AccessControl.ListLocationAdmins

ช่อง
parent

string

ชื่อสถานที่ที่จะแสดงผู้ดูแลระบบ

ListLocationAdminsResponse

ข้อความตอบกลับสำหรับ AccessControl.ListLocationAdmins

ช่อง
admins[]

Admin

คอลเล็กชันของอินสแตนซ์ Admin รายการ

ListLocationsRequest

ข้อความคำขอสำหรับ Locations.ListLocations

ช่อง
parent

string

ชื่อบัญชีที่จะดึงข้อมูลสถานที่ หาก Account มาจาก AccountType ส่วนบุคคล ระบบจะส่งคืนเฉพาะสถานที่ที่บัญชีเป็นเจ้าของโดยตรงเท่านั้น มิฉะนั้นจะแสดงสถานที่ที่เข้าถึงได้ทั้งหมดจากบัญชี ไม่ว่าจะโดยตรงหรือโดยอ้อม

page_size

int32

จำนวนสถานที่ที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 100, ต่ำสุดคือ 1 และขนาดสูงสุดของหน้าเว็บคือ 100

page_token

string

หากระบุไว้ ระบบจะดึงสถานที่ตั้ง page แห่งถัดไป โทเค็นของหน้าเว็บจะส่งคืนจากการเรียกไปยัง ListLocations ครั้งก่อน เมื่อมีสถานที่มากเกินกว่าจะพอดีกับขนาดหน้าที่ร้องขอ

filter

string

ตัวกรองที่จำกัดสถานที่ตั้งที่จะส่งคืน การตอบกลับมีเฉพาะรายการที่ตรงกับตัวกรอง หาก filter ว่างเปล่า ระบบจะใช้ข้อจำกัดและเรียกข้อมูลสถานที่ตั้งทั้งหมด (ใส่เลขหน้า) สำหรับบัญชีที่ขอ

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับช่องที่ถูกต้องและการใช้งานตัวอย่าง โปรดดูคู่มือการใช้ข้อมูลตำแหน่ง

language_code
(deprecated)

string

รหัสภาษา BCP 47 ที่ใช้รับพร็อพเพอร์ตี้ตำแหน่งที่แสดง หากภาษานี้ไม่พร้อมใช้งาน ก็จะให้บริการเป็นภาษาของสถานที่นั้น หากไม่มีทั้ง 2 รูปแบบ ระบบจะให้บริการเป็นภาษาอังกฤษ

เลิกใช้งานแล้ว หลังจากวันที่ 15 สิงหาคม 2020 ระบบจะไม่ใช้ช่องนี้อีกต่อไป แต่ระบบจะใช้ภาษาของสถานที่ตั้งนั้นๆ แทนเสมอ

order_by

string

กำลังจัดเรียงคำขอ ช่องหลายช่องควรคั่นด้วยคอมมาโดยใช้ไวยากรณ์ SQL ต่อไปนี้ ลำดับการจัดเรียงเริ่มต้นคือจากน้อยไปมาก หากต้องการระบุลำดับจากมากไปน้อย ให้ใส่คำต่อท้าย " มากไปน้อย" ควรเพิ่มลงไป ฟิลด์ที่ถูกต้องสำหรับ order_by คือ location_name และ store_code เช่น "location_name, store_code desc" หรือ "location_name" หรือ "store_code desc"

การตอบกลับ ListLocations

ข้อความตอบกลับสำหรับ Locations.ListLocations

ช่อง
locations[]

Location

สถานที่

next_page_token

string

ถ้าจำนวนสถานที่ตั้งเกินขนาดหน้าเว็บที่ขอ ฟิลด์นี้จะมีโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของสถานที่ตั้งในการเรียก ListLocations ครั้งต่อๆ ไป หากไม่มีตำแหน่งเพิ่มเติม ช่องนี้จะไม่ปรากฏในคำตอบ

total_size

int32

จำนวนตำแหน่งโดยประมาณในรายการโดยไม่คำนึงถึงการใส่เลขหน้า

ListMediaItemsRequest

ข้อความคำขอสำหรับ Media.ListMediaItems

ช่อง
parent

string

ชื่อสถานที่ที่จะแสดงรายการสื่อ

page_size

int32

จำนวนรายการสื่อที่จะแสดงต่อ 1 หน้า ค่าเริ่มต้นคือ 100 ซึ่งเป็นจำนวนรายการสื่อที่รองรับสูงสุดที่เพิ่มลงในตำแหน่งด้วย Google My Business API ได้ ขนาดหน้าเว็บสูงสุดคือ 2500

page_token

string

หากระบุไว้จะแสดงหน้าถัดไปของรายการสื่อ

ListMediaItemsResponse

ข้อความตอบกลับสำหรับ Media.ListMediaItems

ช่อง
media_items[]

MediaItem

รายชื่อสื่อที่แสดง

total_media_item_count

int32

จำนวนรายการสื่อทั้งหมดสำหรับสถานที่นี้ โดยไม่คำนึงถึงการใส่เลขหน้า

next_page_token

string

หากมีรายการสื่อมากกว่าขนาดหน้าที่ขอ ฟิลด์นี้จะมีการเติมข้อมูลด้วยโทเค็นเพื่อดึงข้อมูลหน้าถัดไปของรายการสื่อในการเรียก ListMediaItems ที่ตามมา

ListQuestionsRequest

ข้อความคำขอสำหรับ QuestionsAndAnswers.ListQuestions

ช่อง
parent

string

ชื่อสถานที่ที่จะเรียกดูคำถาม

page_size

int32

จำนวนคำถามที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นและค่าสูงสุด page_size ค่าคือ 10

page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลหน้าคำถามถัดไป

answers_per_question

int32

จำนวนคำตอบที่จะดึงข้อมูลต่อคำถาม ค่าเริ่มต้นและค่าสูงสุด answers_per_question ค่าคือ 10

filter

string

ตัวกรองที่จำกัดคำถามให้ส่งคืน ตัวกรองเดียวที่สนับสนุนในขณะนี้คือ "ignore_answered=true"

order_by

string

คำสั่งซื้อที่จะส่งคืนคำถาม ตัวเลือกที่ถูกต้องรวมถึง "update_time desc" และ "upvote_count desc" ซึ่งจะแสดงคำถามโดยจัดเรียงตามช่องที่ขอจากมากไปน้อย ลำดับการจัดเรียงเริ่มต้นคือ "update_time desc"

ListQuestionsResponse

ข้อความตอบกลับสำหรับ QuestionsAndAnswers.ListQuestions

ช่อง
questions[]

Question

คำถามที่ขอ

total_size

int32

จำนวนคำถามทั้งหมดที่โพสต์เกี่ยวกับสถานที่นี้ในทุกหน้า

next_page_token

string

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

ListRecommendedGoogleLocationsRequest

ข้อความขอให้แสดงรายการสถานที่ที่แนะนำสำหรับบัญชี Business Profile

ช่อง
name

string

ชื่อทรัพยากรบัญชีที่ต้องการดึงข้อมูลสถานที่ของ Google ที่แนะนำ

page_size

int32

จำนวนสถานที่ที่จะดึงข้อมูลต่อ 1 หน้า ค่าเริ่มต้นคือ 25, ต่ำสุดคือ 1 และขนาดหน้าเว็บสูงสุดคือ 100

page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลหน้าถัดไปของสถานที่ตั้ง

ListRecommendedGoogleLocationsResponse

ข้อความตอบกลับสำหรับ GoogleLocations.ListFeaturedGoogleLocations

นอกจากนี้ยังมีสถานที่บางแห่งที่ผู้ใช้ Business Profile รายอื่นๆ ได้อ้างสิทธิ์ไว้ตั้งแต่ครั้งล่าสุดที่ระบบแนะนำสถานที่เหล่านั้นกับบัญชี Business Profile นี้

ช่อง
google_locations[]

GoogleLocation

สถานที่ที่แนะนำสำหรับบัญชี Business Profile แต่ละรูปแสดงถึง GoogleLocation ที่มีอยู่ใน Maps โดยสถานที่ตั้งจะจัดเรียงตามความเกี่ยวข้องกับบัญชี Business Profile จากมากไปน้อย

total_size

int32

จํานวนสถานที่ตั้งที่แนะนําทั้งหมดสําหรับบัญชี Business Profile นี้ โดยไม่คำนึงถึงการใส่เลขหน้า

next_page_token

string

ในระหว่างการใส่เลขหน้า หากมีสถานที่ที่จะดึงข้อมูลในหน้าถัดไปเพิ่มเติม ช่องนี้จะมีโทเค็นให้ดึงข้อมูลหน้าถัดไปของสถานที่ต่างๆ ในการโทรครั้งถัดไป หากไม่มีตำแหน่งที่จะดึงข้อมูลเพิ่มเติม ช่องนี้จะไม่ปรากฏในการตอบกลับ

ListReviewsRequest

ข้อความคำขอสำหรับ Reviews.ListReviews

ช่อง
parent

string

ชื่อสถานที่ที่จะดึงข้อมูลรีวิว

page_size

int32

จำนวนรีวิวที่จะดึงข้อมูลต่อ 1 หน้า page_size สูงสุดคือ 50

page_token

string

หากระบุไว้ ระบบจะดึงข้อมูลรีวิวหน้าถัดไป

order_by

string

ระบุช่องเพื่อจัดเรียงรีวิว หากไม่ระบุ ลำดับของรีวิวที่ส่งคืนจะมีค่าเริ่มต้นเป็น update_time desc คำสั่งซื้อที่ถูกต้องที่สามารถจัดเรียงได้คือ rating, rating desc และ update_time desc

ListReviewsResponse

ข้อความตอบกลับสำหรับ Reviews.ListReviews

ช่อง
reviews[]

Review

รีวิว

average_rating

double

ระดับดาวโดยเฉลี่ยของรีวิวทั้งหมดสำหรับสถานที่นี้ตั้งแต่ 1 ถึง 5 โดย 5 คือคะแนนสูงสุด

total_review_count

int32

จำนวนรีวิวทั้งหมดสำหรับสถานที่นี้

next_page_token

string

หากจำนวนรีวิวเกินขนาดของหน้าเว็บที่ขอ ระบบจะเติมข้อมูลในช่องนี้ด้วยโทเค็นเพื่อดึงข้อมูลรีวิวหน้าถัดไปในการเรียกใช้ ListReviews ครั้งถัดไป หากไม่มีรีวิวเพิ่มเติม จะไม่มีฟิลด์นี้ในคำตอบ

ListVerificationsRequest

ข้อความขอ Verifications.List Verifications

ช่อง
parent

string

ชื่อทรัพยากรของตำแหน่งที่มีคำขอการยืนยัน

page_size

int32

จำนวนการยืนยันที่จะใส่ต่อ 1 หน้า หากไม่ได้ตั้งค่า ให้แสดงผลทั้งหมด

page_token

string

หากระบุไว้ จะแสดงหน้าถัดไปของการยืนยัน

ListVerificationsResponse

ข้อความตอบกลับสำหรับ Verifications.List Verifications

ช่อง
verifications[]

Verification

รายการการยืนยัน

next_page_token

string

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

LocalPost

แสดงโพสต์ในพื้นที่สำหรับสถานที่

ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุ Google สำหรับโพสต์ในพื้นที่นี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}/localPosts/{local_post_id}

language_code

string

ภาษาของโพสต์ในพื้นที่

summary

string

คำอธิบาย/เนื้อหาของโพสต์ในท้องถิ่น

call_to_action

CallToAction

URL ที่ผู้ใช้จะไปถึงเมื่อคลิกผ่านโปรโมชัน ละเว้นสำหรับหัวข้อประเภท OFFER

create_time

Timestamp

เอาต์พุตเท่านั้น เวลาที่สร้างโพสต์

update_time

Timestamp

เอาต์พุตเท่านั้น เวลาที่ผู้ใช้แก้ไขโพสต์ครั้งล่าสุด

event

LocalPostEvent

ข้อมูลกิจกรรม ต้องระบุสำหรับหัวข้อประเภท EVENT และ OFFER

state

LocalPostState

เอาต์พุตเท่านั้น สถานะของโพสต์ ซึ่งบ่งชี้ว่าโพสต์อยู่ในส่วนใดของวงจรโฆษณา

media[]

MediaItem

สื่อที่เชื่อมโยงกับโพสต์ source_url เป็นช่องข้อมูลเดียวที่รองรับสำหรับ LocalPost MediaItem

search_url

string

เอาต์พุตเท่านั้น ลิงก์ไปยังโพสต์ในพื้นที่ใน Google Search ลิงก์นี้ใช้เพื่อแชร์โพสต์ผ่านโซเชียลมีเดีย อีเมล ข้อความ ฯลฯ ได้

topic_type

LocalPostTopicType

ต้องระบุ ประเภทหัวข้อของโพสต์ ได้แก่ มาตรฐาน กิจกรรม ข้อเสนอ หรือการแจ้งเตือน

alert_type

AlertType

ประเภทของการแจ้งเตือนที่ใช้สร้างโพสต์ ช่องนี้ใช้ได้กับโพสต์การแจ้งเตือน topic_type เท่านั้น และทำหน้าที่เป็นการแจ้งเตือนประเภทย่อย

offer

LocalPostOffer

ข้อมูลเพิ่มเติมสำหรับโพสต์ข้อเสนอ ควรตั้งค่านี้เมื่อ topic_type เป็น OFFER เท่านั้น

LocalPostState

ระบุว่าโพสต์อยู่ในสถานะใด

Enum
LOCAL_POST_STATE_UNSPECIFIED ไม่ได้ระบุรัฐ
REJECTED โพสต์นี้ถูกปฏิเสธเนื่องจากมีการละเมิดนโยบายเนื้อหา
LIVE โพสต์นี้เผยแพร่แล้วและปรากฏในผลการค้นหา
PROCESSING โพสต์นี้กำลังถูกประมวลผลและไม่ปรากฏในผลการค้นหา

LocalPostEvent

ข้อมูลทั้งหมดที่เกี่ยวข้องกับกิจกรรมที่ปรากฏในโพสต์ในท้องถิ่น

ช่อง
title

string

ชื่อเหตุการณ์

schedule

TimeInterval

วันที่/เวลาเริ่มต้นและสิ้นสุดของกิจกรรม

LocalPostMetrics

เมตริกทั้งหมดที่ขอสำหรับโพสต์ในพื้นที่

ช่อง
local_post_name

string

metric_values[]

MetricValue

รายการค่าของเมตริกที่ขอ

LocalPostOffer

ช่องเฉพาะสำหรับโพสต์ข้อเสนอ

ช่อง
coupon_code

string

ไม่บังคับ รหัสข้อเสนอที่ใช้ได้ในร้านค้าหรือทางออนไลน์

redeem_online_url

string

ไม่บังคับ ลิงก์ออนไลน์สำหรับแลกรับข้อเสนอ

terms_conditions

string

ไม่บังคับ ข้อกำหนดและเงื่อนไขของข้อเสนอ

LocalPostTopicType

ประเภทหัวข้อของโพสต์ในเครื่อง ซึ่งใช้เพื่อเลือกเทมเพลตต่างๆ เพื่อสร้างและแสดงผลโพสต์

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทโพสต์
STANDARD โพสต์มีข้อมูลพื้นฐาน เช่น ข้อมูลสรุปและรูปภาพ
EVENT โพสต์มีข้อมูลพื้นฐานและกิจกรรม
OFFER โพสต์มีข้อมูลพื้นฐาน กิจกรรม และข้อเสนอที่เกี่ยวข้องกับเนื้อหา (เช่น รหัสคูปอง)
ALERT ประกาศที่เกี่ยวข้องกับกิจกรรมที่กำลังดำเนินอยู่ ซึ่งมีลำดับความสำคัญสูงและทันท่วงที บางครั้งโพสต์ประเภทนี้ก็ไม่มีให้เขียน

ตำแหน่ง

สถานที่ อ่านบทความในศูนย์ช่วยเหลือเพื่อดูคำอธิบายโดยละเอียดของช่องเหล่านี้ หรือปลายทางหมวดหมู่เพื่อดูรายการหมวดหมู่ธุรกิจที่ใช้ได้

ช่อง
name

string

ตัวระบุของ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}

ในบริบทของการจับคู่ จะไม่มีการป้อนข้อมูลในช่องนี้

language_code

string

ภาษาของสถานที่ตั้ง ตั้งค่าในระหว่างการสร้างและอัปเดตไม่ได้

store_code

string

ตัวระบุภายนอกสำหรับสถานที่ตั้งนี้ ซึ่งต้องไม่ซ้ำกันในบัญชีหนึ่งๆ นี่คือวิธีการเชื่อมโยงสถานที่กับบันทึกของคุณเอง

location_name

string

ชื่อสถานที่ตั้งควรสื่อถึงชื่อตามจริงของธุรกิจ ตรงตามที่ใช้เป็นประจำที่หน้าร้าน เว็บไซต์ และเครื่องเขียน รวมถึงเป็นชื่อที่ลูกค้ารู้จัก ข้อมูลเพิ่มเติมใดๆ ที่เกี่ยวข้องจะใส่ลงในช่องอื่นๆ ของทรัพยากรได้ (เช่น Address, Categories) อย่าเพิ่มข้อมูลที่ไม่จำเป็นลงในชื่อ (เช่น ใช้ "Google" แทน "Google Inc. - Mountain View Corporate Headquarters" อย่าใส่แท็กไลน์การตลาด, รหัสร้านค้า, สัญลักษณ์พิเศษ, เวลาทำการหรือสถานะเปิด/ปิด, หมายเลขโทรศัพท์, URL ของเว็บไซต์, ข้อมูลเกี่ยวกับบริการ/ผลิตภัณฑ์, สถานที่ตั้ง/ที่อยู่หรือเส้นทาง หรือข้อมูลที่เป็นการล้อมจับ (เช่น "ตู้เอทีเอ็มในกรุงเทพฯ")

primary_phone

string

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

additional_phones[]

string

หมายเลขโทรศัพท์สูงสุด 2 หมายเลข (มือถือหรือโทรศัพท์บ้าน ไม่ใช่แฟกซ์) ที่ลูกค้าใช้โทรไปยังธุรกิจของคุณได้ นอกเหนือจากหมายเลขโทรศัพท์หลัก

address

PostalAddress

ที่อยู่ที่ถูกต้องและชัดเจนเพื่ออธิบายสถานที่ตั้งธุรกิจของคุณ ไม่อนุญาตให้ใช้ตู้ไปรษณีย์หรือตู้จดหมายซึ่งตั้งอยู่ห่างจากที่ตั้งธุรกิจ ขณะนี้คุณระบุค่า address_lines ได้สูงสุด 5 ค่าในที่อยู่

primary_category

Category

หมวดหมู่ที่อธิบายธุรกิจหลักที่สถานที่นี้มีส่วนร่วมได้ดีที่สุด

additional_categories[]

Category

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

website_url

string

URL ของธุรกิจนี้ หากเป็นไปได้ ให้ใช้ URL ที่แสดงถึงที่ตั้งธุรกิจแต่ละแห่งนี้แทนเว็บไซต์/URL ทั่วไปที่แสดงถึงสถานที่ตั้งทั้งหมดหรือแบรนด์

regular_hours

BusinessHours

เวลาทําการของธุรกิจ

special_hours

SpecialHours

เวลาทำการพิเศษของธุรกิจ ซึ่งโดยปกติจะรวมถึงเวลาทำการในวันหยุดและเวลาอื่นๆ นอกเวลาทำการปกติ ซึ่งจะลบล้างเวลาทำการปกติ

service_area

ServiceAreaBusiness

ธุรกิจที่ให้บริการตามสถานที่ให้บริการในสถานที่ตั้งของลูกค้า หากธุรกิจนี้เป็นธุรกิจที่ให้บริการตามสถานที่ ฟิลด์นี้จะอธิบายพื้นที่ที่ธุรกิจให้บริการ

location_key

LocationKey

คอลเล็กชันคีย์ที่เชื่อมโยงธุรกิจนี้กับพร็อพเพอร์ตี้อื่นๆ ของ Google เช่น Google+ เพจและ Google Maps Places

labels[]

string

คอลเล็กชันสตริงรูปแบบอิสระเพื่อให้คุณติดแท็กธุรกิจได้ ป้ายกำกับเหล่านี้ไม่แสดงต่อผู้ใช้ มีเพียงคุณเท่านั้นที่เห็น มีอักขระได้ไม่เกิน 255 ตัว (ต่อป้ายกำกับ)

ad_words_location_extensions

AdWordsLocationExtensions

ข้อมูลเพิ่มเติมที่แสดงใน AdWords

latlng

LatLng

ละติจูดและลองจิจูดที่ผู้ใช้ระบุ เมื่อสร้างตำแหน่ง ระบบจะละเว้นช่องนี้หากที่อยู่ที่ระบุเข้ารหัสพิกัดภูมิศาสตร์สำเร็จ ช่องนี้จะแสดงตามคำขอรับต่อเมื่อมีการยอมรับค่า latlng ที่ได้จากผู้ใช้ระหว่างการสร้าง หรือมีการอัปเดตค่า latlng ผ่านเว็บไซต์ Business Profile ไม่สามารถอัปเดตฟิลด์นี้

open_info

OpenInfo

ธงที่บ่งชี้ว่าสถานที่เปิดให้บริการอยู่หรือไม่

location_state

LocationState

เอาต์พุตเท่านั้น ชุดบูลีนที่สะท้อนสถานะของสถานที่ตั้ง

attributes[]

Attribute

แอตทริบิวต์สำหรับสถานที่นี้

metadata

Metadata

เอาต์พุตเท่านั้น ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้

price_lists[]
(deprecated)

PriceList

เลิกใช้งานแล้ว: ข้อมูลรายการราคาของสถานที่ตั้งนี้

profile

Profile

อธิบายธุรกิจของคุณด้วยเสียงของคุณเอง และแชร์เรื่องราวที่เป็นเอกลักษณ์ของธุรกิจและข้อเสนอของคุณกับผู้ใช้

relationship_data

RelationshipData

สถานที่และเครือทั้งหมดที่เกี่ยวข้องกับสถานที่นี้

more_hours[]

MoreHours

เวลาทําการเพิ่มเติมสําหรับแผนกต่างๆ หรือลูกค้าบางกลุ่ม

ข้อมูลเมตา

ข้อมูลเพิ่มเติมที่ผู้ใช้แก้ไขไม่ได้เกี่ยวกับสถานที่ตั้ง

ช่อง
duplicate
(deprecated)

Duplicate

ข้อมูลเกี่ยวกับสถานที่ซึ่งสถานที่นี้ซ้ำกัน แสดงเมื่อ location_state.is_duplicate เป็นจริงเท่านั้น เลิกใช้งานแล้ว: เราไม่รองรับข้อมูลโดยละเอียดสําหรับรายการที่ซ้ำอีกต่อไป

maps_url

string

ลิงก์ไปยังสถานที่ใน Maps

new_review_url

string

ลิงก์ไปยังหน้าใน Google Search ซึ่งลูกค้าสามารถเขียนรีวิวสำหรับสถานที่ตั้งได้

ทำซ้ำ

ข้อมูลเกี่ยวกับสถานที่ซึ่งสถานที่นี้ซ้ำกัน

ช่อง
location_name

string

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

place_id

string

รหัสสถานที่ของสถานที่ตั้งที่ซ้ำกัน

access

Access

ระบุว่าผู้ใช้มีสิทธิ์เข้าถึงตำแหน่งที่ซ้ำกันหรือไม่

การเข้าถึง

ระดับการเข้าถึงสถานที่ของผู้ใช้ที่ซ้ำกัน สิ่งนี้มาแทนที่การเป็นเจ้าของ และควรใช้แทน

Enum
ACCESS_UNSPECIFIED ไม่ได้ระบุ
ACCESS_UNKNOWN ระบุไม่ได้ว่าผู้ใช้มีสิทธิ์เข้าถึงสถานที่ที่ซ้ำกันหรือไม่
ALLOWED ผู้ใช้มีสิทธิ์เข้าถึงสถานที่ที่ซ้ำกัน
INSUFFICIENT ผู้ใช้ไม่มีสิทธิ์เข้าถึงสถานที่ที่ซ้ำกัน

RelationshipData

ข้อมูลของสถานที่หลักและย่อยทั้งหมดที่เกี่ยวข้องกับสถานที่นี้

ช่อง
parent_chain

string

ชื่อทรัพยากรของเชนที่สถานที่นี้เป็นสมาชิกอยู่ How to find Chain ID

LocationDrivingDirectionMetrics

สถานที่ตั้งที่จัดทำดัชนีพร้อมกับภูมิภาคที่ผู้คนมักมา ข้อมูลนี้ได้จากการนับจำนวนคำขอเส้นทางขับรถมายังตำแหน่งนี้ซึ่งมาจากแต่ละภูมิภาค

ช่อง
location_name

string

ชื่อทรัพยากรสถานที่ตั้งของค่าเมตริกนี้

top_direction_sources[]

TopDirectionSources

คำขอเส้นทางขับรถตามภูมิภาคต้นทาง ตามหลักแล้ว ฟังก์ชันเหล่านี้จะจัดเรียงตามจำนวนโดยแสดงผลลัพธ์ไม่เกิน 10 รายการ

time_zone

string

เขตเวลา (รหัสเขตเวลา IANA เช่น "ยุโรป/ลอนดอน") ของสถานที่ตั้ง

TopDirectionSources

ภูมิภาคยอดนิยมที่เป็นต้นทางของคำขอเส้นทางการขับขี่

ช่อง
day_count

int32

จำนวนวันที่รวบรวมข้อมูล

region_counts[]

RegionCount

ภูมิภาคที่จัดเรียงตามลำดับจากมากไปน้อยตามจำนวน

RegionCount

ภูมิภาคที่มีจำนวนคำขอที่เกี่ยวข้อง

ช่อง
latlng

LatLng

ศูนย์กลางของภูมิภาค

label

string

ป้ายกำกับที่มนุษย์อ่านได้สำหรับภูมิภาค

count

int64

จำนวนคำขอเส้นทางขับรถจากภูมิภาคนี้

LocationKey

ข้อมูลอ้างอิงคีย์สำรอง/ตัวแทนสำหรับสถานที่ตั้ง

ช่อง
plus_page_id

string

เอาต์พุตเท่านั้น หากสถานที่นี้มี Google+ เพจเชื่อมโยงอยู่ ระบบจะแสดงรหัส Google+ เพจสำหรับสถานที่นี้

place_id

string

หากสถานที่นี้ได้รับการยืนยันและเชื่อมต่อ/ปรากฏใน Google Maps ช่องนี้จะกรอกรหัสสถานที่ของสถานที่ตั้ง รหัสนี้สามารถใช้ใน API ของ Places ได้หลายชนิด

หากสถานที่นี้ไม่ได้รับการยืนยัน อาจมีการป้อนข้อมูลในช่องนี้หากสถานที่นี้เชื่อมโยงกับสถานที่ที่ปรากฏใน Google Maps

คุณสามารถตั้งค่าช่องนี้ในระหว่างการสร้างการเรียก แต่ตั้งค่าสำหรับการอัปเดตไม่ได้

บูลีน explicit_no_place_id เพิ่มเติมจะพิจารณาว่ารหัสสถานที่ที่ไม่ได้ตั้งค่าเป็นเจตนาหรือไม่

explicit_no_place_id

bool

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

request_id

string

เอาต์พุตเท่านั้น request_id ใช้เพื่อสร้างสถานที่นี้ อาจว่างเปล่าหากสถานที่นี้สร้างขึ้นภายนอก Google My Business API หรือ Business Profile Locations

LocationMetrics

ชุดเมตริกและเมตริกรายละเอียดที่เชื่อมโยงกับสถานที่ตั้งในช่วงเวลาหนึ่ง

ช่อง
location_name

string

ชื่อทรัพยากรตำแหน่งที่ค่าเหล่านี้เป็นของค่าดังกล่าว

time_zone

string

เขตเวลา IANA ของสถานที่ตั้ง

metric_values[]

MetricValue

รายการค่าของเมตริกที่ขอ

LocationReview

แสดงรีวิวที่มีข้อมูลสถานที่ตั้ง

ช่อง
name

string

ชื่อทรัพยากรของตำแหน่ง

review

Review

รีวิวสำหรับสถานที่

LocationState

มีชุดบูลีนที่แสดงถึงสถานะของตำแหน่ง

ช่อง
is_google_updated

bool

เอาต์พุตเท่านั้น ระบุว่ารหัสสถานที่ที่เชื่อมโยงกับสถานที่นี้มีการอัปเดตหรือไม่

is_duplicate

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ซ้ำกับสถานที่อื่นหรือไม่

is_suspended

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ถูกระงับหรือไม่ ผู้ใช้ปลายทางจะไม่เห็นสถานที่ที่ถูกระงับในผลิตภัณฑ์ของ Google หากคุณเชื่อว่านี่เป็นข้อผิดพลาด โปรดดูบทความในศูนย์ช่วยเหลือ

can_update

bool

เอาต์พุตเท่านั้น ระบุว่าจะอัปเดตตำแหน่งได้หรือไม่

can_delete

bool

เอาต์พุตเท่านั้น ระบุว่าจะลบสถานที่โดยใช้ Google My Business API ได้หรือไม่

is_verified

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ได้รับการยืนยันแล้วหรือไม่

needs_reverification

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ต้องมีการยืนยันอีกครั้งหรือไม่

is_pending_review

bool

เอาต์พุตเท่านั้น ระบุว่าการตรวจสอบสถานที่นี้อยู่ระหว่างรอดำเนินการหรือไม่

is_disabled

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ปิดใช้งานอยู่หรือไม่

is_published

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ได้รับการเผยแพร่หรือไม่

is_disconnected

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ยกเลิกการเชื่อมต่อกับสถานที่ใน Google Maps หรือไม่

is_local_post_api_disabled

bool

เอาต์พุตเท่านั้น ระบุว่ามีการปิดใช้ accounts.locations.localPosts สำหรับสถานที่นี้หรือไม่

can_modify_service_list

bool

เอาต์พุตเท่านั้น ระบุว่ารายชื่อสามารถแก้ไข ServiceList ได้หรือไม่

can_have_food_menus

bool

เอาต์พุตเท่านั้น ระบุว่าข้อมูลมีสิทธิ์ใช้เมนูอาหารหรือไม่

has_pending_edits

bool

เอาต์พุตเท่านั้น ระบุว่าพร็อพเพอร์ตี้ของสถานที่นี้อยู่ในสถานะรอดำเนินการแก้ไขหรือไม่

has_pending_verification

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่มีคำขอการยืนยันที่รอดำเนินการหรือไม่

can_operate_health_data

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ตั้งนั้นดำเนินการเกี่ยวกับข้อมูลสุขภาพได้หรือไม่

can_operate_lodging_data

bool

เอาต์พุตเท่านั้น ระบุว่าสถานที่ให้บริการข้อมูลที่พักได้หรือไม่

MatchedLocation

แสดงการจับคู่ที่เป็นไปได้กับสถานที่ตั้ง

ช่อง
location

Location

สถานที่ตั้งที่มีการป้อนข้อมูลเล็กน้อยซึ่งอาจตรงกัน ช่องที่ไม่มีการป้อนข้อมูลรวมถึงแต่ไม่จํากัดเพียงชื่อ (ระบบไม่สามารถดึงข้อมูลสถานที่ตั้งที่ตรงกันผ่าน GetLocation หรือ BatchGetLocations) store_code; รายละเอียดพื้นที่ครอบคลุมของ service_area labels; ad_words_location_extensions; photos

is_exact_match

bool

นี่เป็นรายการที่ตรงกันทั้งหมดหรือไม่

MediaItem

สื่อรายการเดียว

ช่อง
name

string

ชื่อทรัพยากรสำหรับรายการสื่อนี้ accounts/{account_id}/locations/{location_id}/media/{media_key}

media_format

MediaFormat

รูปแบบของรายการสื่อนี้ ต้องตั้งค่าเมื่อมีการสร้างรายการสื่อและเป็นแบบอ่านอย่างเดียวในคำขออื่นๆ ทั้งหมด อัปเดตไม่ได้

location_association

LocationAssociation

ต้องระบุเมื่อโทรหา CreatePhoto อธิบายว่ารายการสื่อนี้เชื่อมต่อกับตำแหน่งอย่างไร ต้องเป็นหมวดหมู่ (เช่น EXTERIOR) หรือรหัสของรายการราคา

ซึ่งจำเป็นเมื่อเพิ่มสื่อใหม่ไปยังสถานที่ตั้งด้วย CreateMediaItem สำหรับสื่อประเภทอื่นๆ เช่น รูปภาพในโพสต์ในพื้นที่ รูปภาพนี้จะไม่ปรากฏขึ้น

google_url

string

เอาต์พุตเท่านั้น URL ที่โฮสต์โดย Google สำหรับรายการสื่อนี้ URL นี้ไม่ใช่ URL คงที่เนื่องจากอาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไป สำหรับวิดีโอ รูปภาพนี้คือภาพตัวอย่างที่มีไอคอนเล่นซ้อนอยู่

thumbnail_url

string

เอาต์พุตเท่านั้น หากมีการระบุ URL ของภาพขนาดย่อสำหรับรายการสื่อนี้

create_time

Timestamp

เอาต์พุตเท่านั้น เวลาที่สร้างรายการสื่อนี้

dimensions

Dimensions

เอาต์พุตเท่านั้น ขนาด (ความกว้างและความสูง) เป็นพิกเซล

insights

MediaInsights

เอาต์พุตเท่านั้น สถิติสำหรับรายการสื่อนี้

attribution

Attribution

เอาต์พุตเท่านั้น ข้อมูลการระบุแหล่งที่มาของรายการสื่อของลูกค้า คุณต้องแสดงการระบุแหล่งที่มานี้ตามที่ระบุให้กับผู้ใช้ และต้องไม่ลบหรือแก้ไขการระบุแหล่งที่มา

description

string

คำอธิบายสำหรับรายการสื่อนี้ คุณแก้ไขคำอธิบายผ่าน Google My Business API ไม่ได้ แต่จะตั้งค่าได้เมื่อสร้างรายการสื่อใหม่ที่ไม่ใช่รูปภาพปก

ช่องการรวม data แหล่งข้อมูลของรายการสื่อ เมื่อสร้างรายการสื่อใหม่ คุณจะต้องระบุ URL หรือการอ้างอิงข้อมูล

รูปภาพทั้งหมดต้องวัดขนาดอย่างน้อย 250 พิกเซลที่ขอบด้านสั้น และมีขนาดไฟล์อย่างน้อย 10240 ไบต์ ยกเว้นหมวดหมู่ PROFILE และ COVER

รูปภาพที่อัปโหลดทั้งหมดควรเป็นไปตามหลักเกณฑ์ของ Business Profile เกี่ยวกับรูปภาพ data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้

source_url

string

URL ที่เข้าถึงได้แบบสาธารณะซึ่งใช้ดึงข้อมูลรายการสื่อได้

เมื่อสร้างหนึ่งในรายการนี้หรือ data_ref ต้องตั้งค่าให้ระบุแหล่งที่มาของรายการสื่อ

หากใช้ source_url ขณะสร้างรายการสื่อ ระบบจะเติม URL แหล่งที่มานั้นด้วย URL แหล่งที่มานั้นเมื่อมีการดึงข้อมูลรายการสื่อ

ไม่สามารถอัปเดตฟิลด์นี้

data_ref

MediaItemDataRef

อินพุตเท่านั้น การอ้างอิงข้อมูลไบนารีของรายการสื่อตามที่เมธอด StartUploadMediaItemData ได้มา

เมื่อสร้างรายการสื่อ ให้ทำอย่างใดอย่างหนึ่งต่อไปนี้

sourceUrl

หรือ

dataRef

ต้องตั้งค่า

การระบุแหล่งที่มา

ข้อมูลการระบุแหล่งที่มาของรายการสื่อของลูกค้า เช่น ชื่อและรูปโปรไฟล์ของผู้ร่วมให้ข้อมูล

ช่อง
profile_name

string

ชื่อผู้ใช้ที่เป็นแหล่งที่มาของรายการสื่อ

profile_photo_url

string

URL ของภาพขนาดย่อในรูปโปรไฟล์ของผู้ใช้

takedown_url

string

URL ของหน้าลบออก ซึ่งรายการสื่อที่คุณรายงานได้นั้นไม่เหมาะสม

profile_url

string

URL ของหน้าโปรไฟล์ Google Maps ของผู้ใช้ที่มีการระบุแหล่งที่มา

ขนาด

มิติข้อมูลของรายการสื่อ

ช่อง
width_pixels

int32

ความกว้างของรายการสื่อ หน่วยเป็นพิกเซล

height_pixels

int32

ความสูงของรายการสื่อเป็นพิกเซล

LocationAssociation

วิธีเชื่อมโยงรายการสื่อกับตำแหน่ง

ช่อง
ช่องการรวม location_attachment_type สื่อสถานที่ตั้งต้องมีหมวดหมู่หรือรหัสของรายการราคาที่เชื่อมโยงกับสื่อเหล่านั้น สื่อที่ไม่ใช่ตำแหน่ง (เช่น รูปภาพโพสต์ในท้องถิ่น) ต้องไม่มีทั้ง 2 อย่าง location_attachment_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
category

Category

หมวดหมู่ที่มีรูปภาพของสถานที่นี้

price_list_item_id

string

รหัสของรายการราคาที่เชื่อมโยงกับรูปภาพของสถานที่นี้

หมวดหมู่

Enum สำหรับหมวดหมู่รายการสื่อ

Enum
CATEGORY_UNSPECIFIED หมวดหมู่ที่ไม่ได้ระบุ
COVER รูปภาพปก สถานที่หนึ่งมีรูปภาพปกเพียงรูปเดียว
PROFILE รูปโปรไฟล์ สถานที่หนึ่งมีรูปโปรไฟล์เพียงรูปเดียว
EXTERIOR สื่อภายนอก
INTERIOR สื่อภายใน
PRODUCT สื่อของผลิตภัณฑ์
AT_WORK "At-work" สื่อ
FOOD_AND_DRINK สื่ออาหารและเครื่องดื่ม
MENU สื่อเมนู
COMMON_AREA สื่อในพื้นที่ส่วนกลาง
ROOMS สื่อในห้อง
TEAMS สื่อของทีม
ADDITIONAL สื่ออื่นๆ ที่ไม่จัดอยู่ในหมวดหมู่ใดๆ

MediaFormat

Enum สำหรับรูปแบบสื่อ

Enum
MEDIA_FORMAT_UNSPECIFIED ไม่ได้ระบุรูปแบบ
PHOTO รายการสื่อคือรูปภาพ ในเวอร์ชันนี้ ระบบจะรองรับเฉพาะรูปภาพเท่านั้น
VIDEO รายการสื่อเป็นวิดีโอ

MediaInsights

ข้อมูลเชิงลึกและสถิติสำหรับรายการสื่อ

ช่อง
view_count

int64

เอาต์พุตเท่านั้น จํานวนครั้งที่มีการดูรายการสื่อ

MediaItemDataRef

การอ้างอิงข้อมูลไบนารีของรูปภาพของ MediaItem ที่อัปโหลดผ่าน Google My Business API

สร้างการอ้างอิงข้อมูลโดยใช้ StartUploadMediaItemData และใช้การอ้างอิงนี้เมื่ออัปโหลดไบต์ไปยัง [UpdateMedia] และเรียก CreateMediaItem ในภายหลัง

ช่อง
resource_name

string

รหัสที่ไม่ซ้ำกันสำหรับข้อมูลไบนารีของรายการสื่อนี้ ใช้เพื่ออัปโหลดข้อมูลรูปภาพด้วย [UpdateMedia] และเมื่อสร้างรายการสื่อใหม่จากไบต์เหล่านั้นด้วย CreateMediaItem

ตัวอย่างไบต์ของการอัปโหลด: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resource_name}?upload_type=media"

สำหรับสาย CreateMediaItem ให้ตั้งค่าเป็น data_ref ของ MediaItem

ป้ายกำกับที่จะใช้เมื่อแสดงเมนูและองค์ประกอบย่อยต่างๆ

ช่อง
display_name

string

ต้องระบุ ชื่อที่แสดงของคอมโพเนนต์

description

string

ไม่บังคับ ข้อมูลเสริมของคอมโพเนนต์

language_code

string

ไม่บังคับ รหัสภาษา BCP 47 หากภาษาไม่พร้อมใช้งาน ระบบจะใช้ภาษาอังกฤษเป็นค่าเริ่มต้น

เมตริก

เมตริกข้อมูลเกี่ยวกับทรัพยากร

Enum
METRIC_UNSPECIFIED ไม่ได้ระบุเมตริก
ALL ชวเลขเพื่อขอเมตริกที่มีอยู่ทั้งหมด เมตริกที่รวมไว้ใน "ทั้งหมด" จะแตกต่างกันไป และขึ้นอยู่กับทรัพยากรที่มีการขอข้อมูลเชิงลึก
QUERIES_DIRECT จํานวนครั้งที่แสดงทรัพยากรเมื่อค้นหาตําแหน่งโดยตรง
QUERIES_INDIRECT จำนวนครั้งที่แสดงทรัพยากรอันเป็นผลจากการค้นหาตามหมวดหมู่ (เช่น ร้านอาหาร)
QUERIES_CHAIN จำนวนครั้งที่แสดงทรัพยากรอันเป็นผลมาจากการค้นหาเชนของทรัพยากรหรือแบรนด์ที่ขาย เช่น Starbucks, Adidas นี่คือส่วนย่อยของ QUERIES_INDIRECT
VIEWS_MAPS จำนวนครั้งที่มีการดูแหล่งข้อมูลใน Google Maps
ACTIONS_WEBSITE จำนวนครั้งที่มีการคลิกเว็บไซต์
ACTIONS_PHONE จำนวนครั้งที่มีการคลิกหมายเลขโทรศัพท์
ACTIONS_DRIVING_DIRECTIONS จำนวนครั้งที่ขอเส้นทางการขับขี่
PHOTOS_VIEWS_MERCHANT ยอดดูรายการสื่อที่ผู้ขายอัปโหลด
PHOTOS_VIEWS_CUSTOMERS จํานวนการดูรายการสื่อที่ลูกค้าอัปโหลด
PHOTOS_COUNT_MERCHANT จำนวนรายการสื่อทั้งหมดที่ผู้ขายเผยแพร่อยู่ในขณะนี้
PHOTOS_COUNT_CUSTOMERS จำนวนรายการสื่อทั้งหมดที่เผยแพร่อยู่ในขณะนี้ที่ลูกค้าอัปโหลด
LOCAL_POST_VIEWS_SEARCH จำนวนครั้งที่มีการดูโพสต์ในพื้นที่บน Google Search
LOCAL_POST_ACTIONS_CALL_TO_ACTION จำนวนครั้งที่มีการคลิกปุ่มคำกระตุ้นให้ดำเนินการใน Google

MetricOption

ตัวเลือกในการระบุวิธีแสดงข้อมูลในคำตอบ

Enum
METRIC_OPTION_UNSPECIFIED ไม่ได้ระบุตัวเลือกเมตริก คำขอจะมีค่าเริ่มต้นเป็น AGGREGATED_TOTAL
AGGREGATED_TOTAL แสดงผลค่าที่รวบรวมตลอดกรอบเวลา นี่คือค่าเริ่มต้น
AGGREGATED_DAILY แสดงผลค่าที่มีการประทับเวลารายวันในช่วงเวลา
BREAKDOWN_DAY_OF_WEEK ค่าจะแสดงผลเป็นรายละเอียดตามวันของสัปดาห์ ใช้ได้กับ ACTIONS_PHONE เท่านั้น
BREAKDOWN_HOUR_OF_DAY ค่าจะแสดงผลเป็นรายละเอียดตามชั่วโมงของวัน ใช้ได้กับ ACTIONS_PHONE เท่านั้น

MetricRequest

คำขอที่จะแสดงผลค่าสำหรับเมตริก 1 รายการ และตัวเลือกในการส่งกลับค่าเหล่านั้น

ช่อง
metric

Metric

เมตริกที่ขอ

options[]

MetricOption

วิธีที่ค่าควรจะปรากฏเมื่อแสดงผล

MetricValue

ค่าสำหรับเมตริกเดียวจากเวลาเริ่มต้น

ช่อง
metric

Metric

เมตริกที่ใช้ค่า

total_value

DimensionalMetricValue

ค่ารวมทั้งหมดสำหรับเมตริกนี้ ตั้งค่าไว้สำหรับตัวเลือก AGGREGATED_TOTAL

dimensional_values[]

DimensionalMetricValue

ค่ามิติข้อมูลสำหรับเมตริกนี้

MoreHours

ระยะเวลาที่สถานที่เปิดทำการสำหรับธุรกิจบางประเภท

ช่อง
hours_type_id

string

ต้องระบุ ประเภทเวลาทำการ ลูกค้าควรโทรหา {#link businessCategory:BatchGet} เพื่อรับประเภทเวลาทำการที่รองรับตามหมวดหมู่ของสถานที่ตั้ง

periods[]

TimePeriod

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

MoreHoursType

ประเภทเวลาทำการเพิ่มเติมที่ธุรกิจนำเสนอได้นอกเหนือจากเวลาทำการปกติ

ช่อง
hours_type_id

string

เอาต์พุตเท่านั้น รหัสแบบคงที่ที่ Google มีให้สำหรับเวลาทำการประเภทนี้

display_name

string

เอาต์พุตเท่านั้น ชื่อที่แสดงที่เป็นภาษาอังกฤษซึ่งมนุษย์อ่านได้สำหรับประเภทเวลาทำการ

localized_display_name

string

เอาต์พุตเท่านั้น ชื่อที่แสดงซึ่งแปลเป็นภาษาท้องถิ่นซึ่งมนุษย์อ่านได้สำหรับประเภทเวลาทำการ

NetworkState

สถานะของเครือข่ายการประกันที่เกี่ยวข้องกับสถานที่นี้

Enum
NETWORK_STATE_UNSPECIFIED ค่าเริ่มต้น
ACCEPTED เครือข่ายนี้ได้รับการยอมรับจากสถานที่ตั้งนี้
PENDING_ADD มีคำขอที่รอดำเนินการเพื่อเพิ่มเครือข่ายนี้ลงในรายการที่ยอมรับ
PENDING_DELETE มีคำขอที่รอดำเนินการให้นำเครือข่ายนี้ออกจากรายการที่ยอมรับ
NOT_ACCEPTED ตำแหน่งนี้ไม่ยอมรับเครือข่ายนี้

NotificationType

ประเภทการแจ้งเตือนที่ส่งไปยังหัวข้อ Cloud Pub/Sub

Enum
NOTIFICATION_TYPE_UNSPECIFIED ไม่มีประเภทการแจ้งเตือน จะไม่ตรงกับการแจ้งเตือนใดๆ
GOOGLE_UPDATE สถานที่มีการอัปเดตจาก Google ให้ตรวจสอบ ช่อง location_name ในการแจ้งเตือนจะแสดงชื่อทรัพยากรของตำแหน่งพร้อมด้วยการอัปเดตจาก Google
NEW_REVIEW เพิ่มรีวิวใหม่ให้กับสถานที่นี้แล้ว ช่อง review_name ในการแจ้งเตือนจะระบุชื่อทรัพยากรของรีวิวที่เพิ่ม และ location_name จะมีชื่อทรัพยากรของตำแหน่ง
UPDATED_REVIEW อัปเดตรีวิวของสถานที่แล้ว ช่อง review_name ในการแจ้งเตือนจะระบุชื่อทรัพยากรของรีวิวที่เพิ่ม และ location_name จะมีชื่อทรัพยากรของตำแหน่ง
NEW_CUSTOMER_MEDIA ผู้ใช้ Google Maps ได้เพิ่มรายการสื่อใหม่ไปยังตำแหน่งนั้น การแจ้งเตือนจะระบุชื่อทรัพยากรของรายการสื่อใหม่
NEW_QUESTION มีการเพิ่มคำถามใหม่ลงในสถานที่ การแจ้งเตือนจะระบุชื่อทรัพยากรของคำถาม
UPDATED_QUESTION อัปเดตคําถามเกี่ยวกับสถานที่แล้ว การแจ้งเตือนจะระบุชื่อทรัพยากรของคำถาม
NEW_ANSWER มีการเพิ่มคำตอบใหม่ให้กับสถานที่ การแจ้งเตือนจะระบุชื่อแหล่งข้อมูลของคำถามและคำตอบ
UPDATED_ANSWER อัปเดตคําตอบของตําแหน่งแล้ว การแจ้งเตือนจะระบุชื่อแหล่งข้อมูลของคำถามและคำตอบ
UPDATED_LOCATION_STATE ปรับข้อมูล LocationState ของตำแหน่งแล้ว การแจ้งเตือนจะมีฟิลด์มาสก์ของช่อง LocationState ที่อัปเดต

การแจ้งเตือน

หัวข้อ Google Cloud Pub/Sub ที่เผยแพร่การแจ้งเตือนเมื่อมีการอัปเดตตำแหน่งหรือมีรีวิวใหม่ แต่ละบัญชีจะมีทรัพยากรการตั้งค่าการแจ้งเตือนเพียง 1 รายการเท่านั้น

ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรการแจ้งเตือน

topic_name

string

หัวข้อ Google Cloud Pub/Sub ที่จะได้รับการแจ้งเตือนเมื่อมีการอัปเดตสถานที่ตั้งที่จัดการโดยบัญชีนี้ หากไม่ได้ตั้งค่า ระบบจะไม่โพสต์การแจ้งเตือน

บัญชี mybusiness-api-pubsub@system.gserviceaccount.com ต้องมีสิทธิ์เผยแพร่ในหัวข้อ Cloud Pub/Sub เป็นอย่างน้อย

notification_types[]

NotificationType

ประเภทการแจ้งเตือนที่จะส่งไปยังหัวข้อ Cloud Pub/Sub ต้องระบุอย่างน้อย 1 รายการ หากต้องการหยุดรับการแจ้งเตือนทั้งหมด ให้ใช้ DeleteNotifications

NutritionFacts

ข้อความนี้แสดงข้อมูลโภชนาการสำหรับอาหาร

ช่อง
calories

CaloriesFact

ไม่บังคับ แคลอรี่ของอาหาร

total_fat

NutritionFact

ไม่บังคับ ข้อมูลไขมันสำหรับอาหารแต่ละชนิด

cholesterol

NutritionFact

ไม่บังคับ ข้อมูลคอเลสเตอรอลสำหรับอาหารแต่ละชนิด

sodium

NutritionFact

ไม่บังคับ ข้อมูลโซเดียมสำหรับอาหารแต่ละชนิด

total_carbohydrate

NutritionFact

ไม่บังคับ ข้อมูลคาร์โบไฮเดรตสำหรับอาหารแต่ละจาน

protein

NutritionFact

ไม่บังคับ ข้อมูลโปรตีนสำหรับอาหารแต่ละมื้อ

CaloriesFact

ข้อความนี้แสดงถึงข้อมูลแคลอรีโดยมีขอบเขตบนและช่วงขอบเขตล่าง ต้องระบุจำนวนเงินต่ำกว่า ทั้งจำนวนเงินต่ำสุดและสูงสุดเป็นจำนวนที่ไม่ติดลบ

ช่อง
lower_amount

int32

ต้องระบุ ปริมาณแคลอรีลดลง

upper_amount

int32

ไม่บังคับ ปริมาณแคลอรี่ที่สูงขึ้น

unit

EnergyUnit

ต้องระบุ หน่วยของข้อมูลแคลอรีที่ระบุ

EnergyUnit

หน่วยพลังงานอาหารที่เป็นไปได้ (แคลอรี)

Enum
ENERGY_UNIT_UNSPECIFIED ไม่ได้ระบุหน่วยพลังงาน
CALORIE แคลอรี่
JOULE Joule

MassUnit

หน่วยมวลที่เป็นไปได้

Enum
MASS_UNIT_UNSPECIFIED ไม่ได้ระบุหน่วยมวล
GRAM กรัม
MILLIGRAM มิลลิกรัม

NutritionFact

ข้อความนี้แสดงถึงข้อมูลโภชนาการที่มีขอบเขตบนและขอบเขตล่าง และสามารถแสดงด้วยหน่วยมวล ต้องระบุจำนวนเงินต่ำกว่า ทั้งจำนวนเงินต่ำสุดและสูงสุดเป็นจำนวนที่ไม่ติดลบ

ช่อง
lower_amount

double

ต้องระบุ ปริมาณโภชนาการลดลง

upper_amount

double

ไม่บังคับ ปริมาณโภชนาการสูง

unit

MassUnit

ต้องระบุ หน่วยของข้อมูลโภชนาการที่ระบุ

OpenInfo

ข้อมูลเกี่ยวกับสถานะการเปิดของธุรกิจ

ช่อง
status

OpenForBusiness

ระบุว่าสถานที่เปิดให้บริการอยู่หรือไม่ สถานที่ทั้งหมดจะเปิดโดยค่าเริ่มต้น เว้นแต่จะอัปเดตให้ปิด

can_reopen

bool

เอาต์พุตเท่านั้น ระบุว่าธุรกิจนี้มีสิทธิ์กลับมาเปิดให้บริการอีกครั้งหรือไม่

opening_date

Date

วันที่เปิดสถานที่เป็นครั้งแรก หากไม่ทราบวันที่ที่แน่นอน คุณจะระบุได้เฉพาะเดือนและปี วันที่ต้องเป็นวันที่ที่ผ่านมาแล้วหรือไม่เกิน 1 ปีนับจากปัจจุบัน

OpenForBusiness

ระบุสถานะของสถานที่

Enum
OPEN_FOR_BUSINESS_UNSPECIFIED ไม่ได้ระบุ
OPEN บ่งบอกว่าสถานที่เปิดอยู่
CLOSED_PERMANENTLY ระบุว่าสถานที่ปิดถาวรแล้ว
CLOSED_TEMPORARILY บ่งบอกว่าสถานที่นี้ปิดชั่วคราวแล้ว ค่านี้ใช้ได้กับสถานที่ที่เผยแพร่แล้ว (เช่น location_state.is_published = true) เท่านั้น เมื่ออัปเดตช่องสถานะเป็นค่านี้ ลูกค้าจะต้องตั้งค่า update_mask เป็น open_info.status อย่างชัดเจน คุณไม่สามารถตั้งค่ามาสก์สำหรับการอัปเดตอื่นๆ ในระหว่างการเรียกใช้การอัปเดตนี้ ข้อจำกัดนี้เป็นข้อจำกัดชั่วคราวซึ่งเราจะผ่อนปรนในเร็วๆ นี้

PermissionLevel

ระบุระดับการเข้าถึงที่ผู้ใช้ซึ่งผ่านการตรวจสอบสิทธิ์แล้วมีสำหรับบัญชีนี้

Enum
PERMISSION_LEVEL_UNSPECIFIED ไม่ได้ระบุ
OWNER_LEVEL ผู้ใช้มีสิทธิ์ระดับเจ้าของ
MEMBER_LEVEL ผู้ใช้มีสิทธิ์ระดับสมาชิก

PhoneInput

อินพุตสำหรับการยืนยัน PHONE_CALL/SMS

ช่อง
phone_number

string

หมายเลขโทรศัพท์ที่ควรโทรหาหรือส่ง SMS ถึง ต้องเป็นหมายเลขโทรศัพท์หนึ่งในตัวเลือกที่มีสิทธิ์

PlaceInfo

กำหนดพื้นที่ที่แสดงด้วยรหัสสถานที่

ช่อง
name

string

ชื่อที่แปลแล้วของสถ านที่ เช่น Scottsdale, AZ

place_id

string

รหัสของสถานที่ ต้องตรงกับภูมิภาค

สถานที่

ระบุการรวมพื้นที่ที่แสดงโดยกลุ่มสถานที่

ช่อง
place_infos[]

PlaceInfo

พื้นที่ที่แสดงด้วยรหัสสถานที่ จำกัดไว้ที่สูงสุด 20 สถานที่

PointRadius

รัศมีรอบจุดใดจุดหนึ่ง (ละติจูด/ลองจิจูด)

ช่อง
latlng

LatLng

ละติจูด/ลองจิจูดที่ระบุศูนย์กลางของพื้นที่ซึ่งระบุโดยรัศมี

radius_km

float

ระยะทางเป็นกิโลเมตรของพื้นที่รอบๆ จุด

PreparationMethod

วิธีเตรียมอาหาร

Enum
PREPARATION_METHOD_UNSPECIFIED ไม่ได้ระบุวิธีการเตรียมการ
BAKED ขนมอบ
BARBECUED วิธีทำบาร์บีคิว
BASTED วิธีการแบบ Basted
BLANCHED วิธีทำเบลนด์
BOILED วิธีต้ม
BRAISED วิธีการตุ๋น
CODDLED วิธีการ Codd
FERMENTED วิธีการหมัก
FRIED วิธีการทอด
GRILLED วิธีการย่าง
KNEADED วิธีการคีบ
MARINATED วิธีหมัก
PAN_FRIED วิธีทอด
PICKLED วิธีดอง
PRESSURE_COOKED วิธีปรุงอาหารด้วยแรงดัน
ROASTED การคั่ว
SAUTEED วิธีผัด
SEARED วิธีการซอร์ฟ
SIMMERED วิธีการเคี่ยว
SMOKED กระบวนการรมควัน
STEAMED วิธีนึ่ง
STEEPED วิธีการที่ซับซ้อน
STIR_FRIED วิธีผัด
OTHER_METHOD วิธีอื่น

PriceList

เลิกใช้งานแล้ว: รายการข้อมูลราคาสินค้า รายการราคามีโครงสร้างเป็นรายการราคาอย่างน้อย 1 รายการ โดยแต่ละรายการจะมีส่วนอย่างน้อย 1 ส่วนที่มีรายการอย่างน้อย 1 รายการ เช่น รายการราคาอาหารอาจแสดงเมนูอาหารเช้า/อาหารกลางวัน/อาหารเย็น พร้อมด้วยส่วนสำหรับเบอร์เกอร์/สเต็ก/อาหารทะเล

ช่อง
price_list_id

string

ต้องระบุ รหัสของรายการราคา ทำซ้ำรายการราคา ส่วน และรหัสสินค้าภายในสถานที่ตั้งนี้ไม่ได้

labels[]

Label

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับรายการราคา

source_url

string

URL แหล่งที่มาที่ไม่บังคับของต้นทางที่ดึงข้อมูลรายการราคา ตัวอย่างเช่น URL ของหน้าที่คัดลอกมาโดยอัตโนมัติเพื่อป้อนข้อมูลเมนู

sections[]

Section

ต้องระบุ ส่วนต่างๆ สำหรับรายการราคานี้ รายการราคาแต่ละรายการต้องมีอย่างน้อย 1 ส่วน

ป้ายกำกับ

ป้ายกำกับที่จะใช้เมื่อแสดงรายการราคา ส่วน หรือสินค้า

ช่อง
display_name

string

ต้องระบุ ชื่อที่แสดงสำหรับรายการราคา ส่วน หรือสินค้า

description

string

ไม่บังคับ คําอธิบายรายการราคา ส่วน หรือสินค้า

language_code

string

ไม่บังคับ รหัสภาษา BCP-47 ที่สตริงเหล่านี้มีผลบังคับใช้ ตั้งค่าป้ายกำกับได้เพียง 1 ชุดต่อภาษาเท่านั้น

ส่วน

ส่วนของรายการราคาที่มีสินค้าอย่างน้อย 1 รายการ

ช่อง
section_id

string

ต้องระบุ รหัสของส่วนช่อง ทำซ้ำรายการราคา ส่วน และรหัสสินค้าภายในสถานที่ตั้งนี้ไม่ได้

labels[]

Label

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับส่วนนี้ เราขอแนะนำว่าชื่อและคำอธิบายส่วนควรมีอักขระไม่เกิน 140 ตัว ต้องระบุป้ายกำกับอย่างน้อย 1 ชุด

section_type

SectionType

ไม่บังคับ ประเภทของส่วนรายการราคาปัจจุบัน ค่าเริ่มต้นคือ FOOD

items[]

Item

สินค้าที่อยู่ในส่วนนี้ของรายการราคา

รายการ

รายการเดียว สินค้าแต่ละรูปแบบในรายการราคาควรมีสินค้าพร้อมข้อมูลราคาของตนเอง

ช่อง
item_id

string

ต้องระบุ รหัสของสินค้า ทำซ้ำรายการราคา ส่วน และรหัสสินค้าภายในสถานที่ตั้งนี้ไม่ได้

labels[]

Label

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับรายการ เราขอแนะนำว่าชื่อสินค้าควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 250 ตัว ต้องระบุป้ายกำกับอย่างน้อย 1 ชุด

price

Money

ไม่บังคับ ราคาของสินค้า

SectionType

ประเภทของส่วน

Enum
SECTION_TYPE_UNSPECIFIED ไม่ได้ระบุ
FOOD ส่วนมีรายการต่างๆ ที่แสดงถึงอาหาร
SERVICES ส่วนมีรายการที่แสดงถึงบริการ

โปรไฟล์

ข้อมูลทั้งหมดที่เกี่ยวข้องกับโปรไฟล์ของตำแหน่ง

ช่อง
description

string

คำอธิบายสถานที่ด้วยเสียงของคุณเอง คนอื่นแก้ไขไม่ได้

คำถาม

แสดงถึงคำถามข้อเดียวและบางคำตอบ

ช่อง
name

string

เอาต์พุตเท่านั้น ชื่อที่ไม่ซ้ำกันของคำถาม accounts/*/locations/*/questions/*

author

Author

เอาต์พุตเท่านั้น ผู้เขียนคำถาม

upvote_count

int32

เอาต์พุตเท่านั้น จํานวนการโหวตเห็นด้วยสําหรับคําถามนี้

text

string

ข้อความสำหรับคำถาม ควรประกอบด้วยคำอย่างน้อย 3 คำ และความยาวรวมควรมากกว่าหรือเท่ากับ 10 อักขระ โดยมีความยาวสูงสุด 4,096 อักขระ

create_time

Timestamp

เอาต์พุตเท่านั้น การประทับเวลาที่ตั้งคำถาม

update_time

Timestamp

เอาต์พุตเท่านั้น การประทับเวลาเมื่อแก้ไขคำถามครั้งล่าสุด

top_answers[]

Answer

เอาต์พุตเท่านั้น รายการคําตอบของคําถามที่จัดเรียงตามการโหวตเห็นด้วย รายการคำตอบนี้อาจไม่ใช่รายการคำตอบทั้งหมด ทั้งนี้ขึ้นอยู่กับพารามิเตอร์คำขอ (answers_per_question)

total_answer_count

int32

เอาต์พุตเท่านั้น จำนวนคำตอบทั้งหมดที่โพสต์สำหรับคำถามนี้

RepeatedEnumAttributeValue

ค่าของแอตทริบิวต์ที่มี value_type เป็น REPEATED_ENUM ซึ่งประกอบด้วยรายการรหัสค่า 2 รายการ ได้แก่ รหัสที่ตั้งค่า (จริง) และรหัสที่ไม่ได้ตั้งค่า (เท็จ) ค่าที่ขาดหายไปจะถือว่าไม่ทราบ ต้องระบุอย่างน้อย 1 ค่า

ช่อง
set_values[]

string

ค่า enum ที่ตั้งค่าไว้

unset_values[]

string

ค่า enum ที่ยังไม่ได้ตั้งค่า

ReportGoogleLocationRequest

ข้อความคำขอรายงาน GoogleLocation

ช่อง
name

string

ชื่อทรัพยากรของ [GoogleLocation] ในรูปแบบ googleLocations/{googleLocationId}

location_group_name

string

ไม่บังคับ ชื่อทรัพยากรของกลุ่มสถานที่ตั้งที่รายงานตำแหน่งของ Google นี้ให้ในรูปแบบ accounts/{account_id}

report_reason_elaboration

string

ไม่บังคับ การป้อนข้อความที่ให้คำอธิบายถึงเหตุผลที่ผู้ใช้รายงานสถานที่นี้ มีความยาวได้สูงสุดไม่เกิน 512 อักขระ

report_reason_language_code

string

ไม่บังคับ รหัส BCP 47 ของภาษาที่ใช้ใน report_reason_elaboration

ช่องการรวม report_reason เหตุผลที่ตำแหน่งนี้ได้รับการรายงาน โปรดระบุเหตุผล report_reason ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
report_reason_bad_location

BadLocationReason

เหตุผลที่ผู้ใช้รายงานตำแหน่งนี้ เมื่อปัญหาเกี่ยวข้องกับสถานที่เอง

report_reason_bad_recommendation

BadRecommendationReason

เหตุผลที่ผู้ใช้รายงานสถานที่นี้เมื่อพบปัญหาเกี่ยวกับคำแนะนำ รายงานนี้มีประโยชน์หากมีการแนะนําสถานที่ตั้งดังกล่าวให้กับบัญชี Business Profile

BadLocationReason

ชุดของเหตุผลที่เป็นไปได้ในการรายงานตำแหน่งเมื่อมีปัญหาเกี่ยวกับคุณภาพของข้อมูลในสถานที่ตั้งนั้นๆ

Enum
BAD_LOCATION_REASON_UNSPECIFIED ไม่ได้ระบุ
NOT_A_LOCATION ตำแหน่งที่แนะนำไม่ใช่ตำแหน่งจริง
PERMANENTLY_CLOSED สถานที่ที่แนะนำปิดถาวรแล้ว
DOES_NOT_EXIST ไม่มีตำแหน่งที่แนะนำ
SPAM สถานที่ที่แนะนำเป็นสแปม ปลอม หรือไม่เหมาะสม
NOT_A_BUSINESS ตำแหน่งที่แนะนำคือสถานที่หรือบ้านส่วนตัว
MOVED

ตำแหน่งที่แนะนำย้ายไปยังตำแหน่งที่ตั้งใหม่แล้ว

ควรมี report_reason_elaboration ซึ่งระบุที่อยู่ใหม่ด้วย

DUPLICATE สถานที่ที่แนะนำนี้ซ้ำกับสถานที่อื่น

BadRecommendationReason

ชุดสาเหตุที่เป็นไปได้ในการรายงานสถานที่เมื่อมีปัญหาเกี่ยวกับคุณภาพของคําแนะนํา (เมื่อแนะนําสถานที่นี้ให้กับผู้ใช้)

Enum
BAD_RECOMMENDATION_REASON_UNSPECIFIED ไม่ได้ระบุ
NOT_A_STORE_FRONT ตำแหน่งที่แนะนำไม่ใช่หน้าร้าน
NOT_PART_OF_SUGGESTED_CHAIN

สถานที่ที่แนะนำไม่ได้เป็นของเครือธุรกิจที่แนะนำใน chain_display_name ในสถานที่ที่ส่งคืน

ควรมี report_reason_elaboration ที่ระบุชื่อของเชนที่ถูกต้องด้วย

IRRELEVANT

ตำแหน่งที่แนะนำไม่เกี่ยวข้องกับผู้ใช้

ควรมี report_reason_elaboration ประกอบกับคำอธิบายว่าเหตุใดคำแนะนำจึงไม่เกี่ยวข้อง

ReportLocalPostInsightsRequest

ขอข้อความสำหรับ Insights.ReportLocalPostInsights

ช่อง
name

string

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

local_post_names[]

string

ต้องระบุ รายการโพสต์ที่จะดึงข้อมูลข้อมูลเชิงลึก โพสต์ทั้งหมดต้องอยู่ในตำแหน่งที่ระบุชื่อไว้ในช่อง name

basic_request

BasicMetricsRequest

คำขอรวมข้อมูลเชิงลึกเกี่ยวกับเมตริกพื้นฐานในรายงาน คำขอนี้มีผลกับโพสต์ทั้งหมดที่ขอ

ReportLocalPostInsightsResponse

ข้อความตอบกลับสำหรับ Insights.ReportLocalPostInsights

ช่อง
name

string

local_post_metrics[]

LocalPostMetrics

1 รายการต่อโพสต์ที่ขอซึ่งเกี่ยวข้องกับสถานที่นี้

time_zone

string

เขตเวลา (รหัสเขตเวลา IANA เช่น "ยุโรป/ลอนดอน") ของสถานที่ตั้ง

ReportLocationInsightsRequest

ขอข้อความ Insights.ReportLocationInsights

ช่อง
name

string

ชื่อทรัพยากรบัญชี

location_names[]

string

คอลเล็กชันของสถานที่ตั้งที่จะดึงข้อมูลข้อมูลเชิงลึกซึ่งระบุตามชื่อ

basic_request

BasicMetricsRequest

คำขอรวมข้อมูลเชิงลึกเกี่ยวกับเมตริกพื้นฐานในรายงาน

driving_directions_request

DrivingDirectionMetricsRequest

คำขอให้รวมข้อมูลเชิงลึกเกี่ยวกับคำขอเส้นทางการขับขี่ในรายงาน

ReportLocationInsightsResponse

ข้อความตอบกลับสำหรับ Insights.ReportLocationInsights

ช่อง
location_metrics[]

LocationMetrics

คอลเล็กชันของค่าเมตริกตามสถานที่ตั้ง

location_driving_direction_metrics[]

LocationDrivingDirectionMetrics

คอลเล็กชันของค่าสำหรับเมตริกที่เกี่ยวกับเส้นทางการขับขี่

ตรวจสอบ

เอาต์พุตเท่านั้น แสดงรีวิวสำหรับสถานที่

ช่อง
name

string

ชื่อทรัพยากร ปุ่ม "ขอรับการตรวจสอบ" อยู่ในรูปแบบ accounts/{account_id}/locations/{location_id}/reviews/{review_id}

review_id

string

ตัวระบุที่ไม่ซ้ำกันที่เข้ารหัส

reviewer

Reviewer

ผู้เขียนรีวิว

star_rating

StarRating

การให้ดาวของรีวิว

comment

string

เนื้อหาของรีวิวในรูปแบบข้อความธรรมดาที่มีมาร์กอัป

create_time

Timestamp

การประทับเวลาที่เขียนรีวิว

update_time

Timestamp

การประทับเวลาที่แก้ไขรีวิวครั้งล่าสุด

review_reply

ReviewReply

เจ้าของ/ผู้จัดการของการตอบกลับรีวิวนี้ของสถานที่นี้

ผู้เขียนรีวิว

แสดงผู้เขียนรีวิว

ช่อง
profile_photo_url

string

ลิงก์รูปโปรไฟล์ของผู้รีวิว ระบบจะป้อนข้อมูลก็ต่อเมื่อ is_anonymous มีค่าเป็น "เท็จ" เท่านั้น

display_name

string

ชื่อผู้รีวิว ป้อนข้อมูลด้วยชื่อจริงของผู้รีวิวหาก is_anonymous เป็นเท็จเท่านั้น

is_anonymous

bool

ระบุว่าผู้รีวิวเลือกที่จะไม่ระบุชื่อหรือไม่

StarRating

การให้ดาวจาก 5 ดาว โดย 5 คือคะแนนสูงสุด

Enum
STAR_RATING_UNSPECIFIED ไม่ได้ระบุ
ONE 1 ดาวจากสูงสุด 5 ดาว
TWO 2 ดาวจากสูงสุด 5 ดาว
THREE 3 ดาวจากสูงสุด 5 ดาว
FOUR 4 ดาวจากสูงสุด 5 ดาว
FIVE จำนวนดาวสูงสุด

ReviewReply

แสดงการตอบรีวิวของเจ้าของ/ผู้จัดการ

ช่อง
comment

string

เนื้อหาของการตอบกลับในรูปแบบข้อความธรรมดาที่มีมาร์กอัป โดยมีความยาวสูงสุด 4,096 ไบต์

update_time

Timestamp

เอาต์พุตเท่านั้น การประทับเวลาที่แก้ไขการตอบครั้งล่าสุด

SearchChainsRequest

ข้อความคำขอสำหรับ Locations.SearchChains

ช่อง
chain_display_name

string

ค้นหาเครือธุรกิจตามชื่อ รองรับการค้นหาที่ตรงทั้งหมด/บางส่วน/ไม่แน่นอน/ที่เกี่ยวข้อง เช่น "walmart", "wal-mart", "walmmmart", "沃尔玛"

result_count

int32

จำนวนสูงสุดของเชนที่ตรงกันที่จะแสดงจากการค้นหานี้ ค่าเริ่มต้นคือ 10 ค่าสูงสุดที่เป็นไปได้คือ 500

SearchChainsResponse

ข้อความตอบกลับสำหรับ Locations.SearchChains

ช่อง
chains[]

Chain

เชนที่ตรงกับChain_display_name ที่ค้นหาใน SearchChainsRequest หากไม่มีรายการที่ตรงกัน ช่องนี้จะว่างเปล่า ผลลัพธ์จะแสดงตามลำดับความเกี่ยวข้อง

SearchGoogleLocationsRequest

ข้อความคำขอสำหรับ GoogleLocations.SearchGoogleLocations

ช่อง
result_count

int32

จำนวนรายการที่ตรงกันที่จะส่งคืน ค่าเริ่มต้นคือ 3 แต่สูงสุด 10 รายการ โปรดทราบว่าเวลาในการตอบสนองอาจเพิ่มขึ้นหากมีการร้องขอเพิ่มเติม โดยไม่มีการใส่เลขหน้า

ช่องการรวม search_query คำค้นหา ซึ่งสามารถระบุเป็นออบเจ็กต์ตำแหน่งหรือการค้นหาสตริงก็ได้ search_query ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
location

Location

ตำแหน่งที่จะค้นหา หากระบุ ระบบจะค้นหาสถานที่ตั้งที่ตรงกับรายละเอียดสถานที่ตั้งที่ให้ไว้

query

string

ข้อความค้นหาที่จะค้นหา ผลการค้นหาจากสตริงการค้นหาจะมีความแม่นยำน้อยกว่าการระบุตำแหน่งที่แน่นอน แต่ก็สามารถแสดงการจับคู่ที่ไม่ตรงกันมากกว่า

SearchGoogleLocationsResponse

ข้อความตอบกลับสำหรับ GoogleLocations.SearchGoogleLocations

ช่อง
google_locations[]

GoogleLocation

คอลเล็กชันของ GoogleLocations ที่อาจตรงกับคำขอที่ระบุ โดยเรียงลำดับจากความแม่นยำมากที่สุดไปน้อยที่สุด

ServiceAreaBusiness

ธุรกิจที่ให้บริการตามสถานที่ให้บริการในสถานที่ตั้งของลูกค้า (เช่น ช่างทำกุญแจหรือช่างประปา)

ช่อง
business_type

BusinessType

ระบุ type ของธุรกิจที่ให้บริการตามสถานที่

ช่องการรวม coverageArea ระบุพื้นที่ครอบคลุมที่ธุรกิจให้บริการ coverageArea ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
radius

PointRadius

เอาต์พุตเท่านั้น พื้นที่ที่ธุรกิจนี้ให้บริการโดยมีจุดศูนย์กลางอยู่ที่จุดใดจุดหนึ่ง

places

Places

พื้นที่ที่ธุรกิจนี้ให้บริการนั้นระบุผ่านกลุ่มสถานที่

BusinessType

ระบุว่าธุรกิจนี้ให้บริการในสถานที่ของลูกค้าเท่านั้น (เช่น รถลาก) หรือทั้งที่อยู่และภายในร้าน (เช่น ร้านพิซซ่ามีพื้นที่รับประทานอาหาร ซึ่งมีบริการส่งลูกค้าด้วย)

Enum
BUSINESS_TYPE_UNSPECIFIED เอาต์พุตเท่านั้น ไม่ได้ระบุ
CUSTOMER_LOCATION_ONLY ให้บริการเฉพาะบริเวณรอบๆ (ไม่ใช่ที่อยู่ธุรกิจ)
CUSTOMER_AND_BUSINESS_LOCATION ให้บริการในที่อยู่ธุรกิจและบริเวณโดยรอบ

ServiceBusinessContext

ข้อมูลเพิ่มเติมสำหรับการยืนยันธุรกิจที่ให้บริการ

ช่อง
address

PostalAddress

ที่อยู่สำหรับการยืนยันของสถานที่ตั้ง ซึ่งใช้เพื่อเปิดใช้งานตัวเลือกการยืนยันเพิ่มเติมหรือส่งไปรษณียบัตร

ServiceList

รายการบริการที่มีรายการบริการอย่างน้อย 1 รายการ

ช่อง
name

string

ต้องระบุ ตัวระบุของ Google สำหรับสถานที่ตั้งนี้ในรูปแบบ: accounts/{account_id}/locations/{location_id}/serviceList

service_items[]

ServiceItem

รายการบริการที่อยู่ในรายการบริการนี้ ระบบจะนำรายการบริการที่ซ้ำกันออกโดยอัตโนมัติ

ServiceItem

ข้อความที่อธิบายรายการบริการเดียว ซึ่งใช้เพื่ออธิบายประเภทบริการที่ผู้ขายมีให้ ตัวอย่างเช่น การตัดผมเป็นบริการหนึ่ง

ช่อง
is_offered

bool

ไม่บังคับ ช่องนี้กำหนดว่าผู้ขายจะเสนอบริการป้อนข้อมูลหรือไม่

price

Money

ไม่บังคับ แสดงราคาเป็นตัวเงินของรายการบริการ เราขอแนะนำให้ตั้งค่า currency_code และ unit เมื่อมีการระบุราคา

ช่องการรวม service_item_info ควรตั้งค่าช่องใดช่องหนึ่งต่อไปนี้เสมอ service_item_info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
structured_service_item

StructuredServiceItem

ช่องนี้จะกำหนดลักษณะตัวพิมพ์ของข้อมูลบริการที่มีโครงสร้าง

free_form_service_item

FreeFormServiceItem

ช่องนี้จะเป็นการตั้งค่าลักษณะตัวจำลองของข้อมูลบริการรูปแบบอิสระ

FreeFormServiceItem

แสดงบริการรูปแบบอิสระที่ผู้ขายนำเสนอ บริการเหล่านี้คือบริการที่ไม่มีการเปิดเผยเป็นส่วนหนึ่งของข้อมูลบริการที่มีโครงสร้าง ผู้ขายป้อนชื่อของบริการดังกล่าวด้วยตนเองผ่านแพลตฟอร์มผู้ขายทางภูมิศาสตร์

ช่อง
category_id

string

ต้องระบุ category_id และ service_type_id ควรตรงกับชุดค่าผสมที่เป็นไปได้ที่ระบุไว้ในข้อความ Category

label

Label

ต้องระบุ ป้ายกำกับที่ติดแท็กภาษาสำหรับรายการ เราขอแนะนำว่าชื่อสินค้าควรมีอักขระไม่เกิน 140 ตัว และคำอธิบายที่มีอักขระไม่เกิน 250 ตัว ควรตั้งค่าช่องนี้เฉพาะเมื่ออินพุตเป็นรายการบริการที่กำหนดเอง ประเภทบริการที่เป็นมาตรฐานควรอัปเดตผ่าน service_type_id

StructuredServiceItem

หมายถึงบริการที่มีโครงสร้างซึ่งผู้ขายเสนอ เช่น toilet_installation

ช่อง
service_type_id

string

ต้องระบุ ช่อง service_type_id คือรหัสที่ไม่ซ้ำกันที่ Google ให้ไว้ซึ่งพบใน ServiceTypeMetadata ข้อมูลนี้ได้รับโดยบริการ Rpc ของ BatchGetBusinessCategory

description

string

ไม่บังคับ คำอธิบายรายการบริการที่มีโครงสร้าง จํานวนอักขระสูงสุดคือ 300 ตัว

ServiceType

ข้อความที่อธิบายประเภทบริการที่ธุรกิจเสนอ

ช่อง
service_type_id

string

เอาต์พุตเท่านั้น รหัสแบบคงที่ (มาจาก Google) สำหรับบริการประเภทนี้

display_name

string

เอาต์พุตเท่านั้น ชื่อที่แสดงที่มนุษย์อ่านได้สำหรับประเภทบริการ

SpecialHourPeriod

แสดงช่วงเวลาเดียวที่เวลาทำการของสถานที่ต่างจากเวลาทำการปกติ ช่วงเวลาพิเศษต้องแสดงช่วงเวลาน้อยกว่า 24 ชั่วโมง open_time และ start_date ต้องมาก่อน close_time และ end_date close_time และ end_date สามารถขยายเวลาจนถึง 11:59 น. ของวันหลัง start_date ที่ระบุ ตัวอย่างเช่น อินพุตต่อไปนี้ถูกต้อง

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

อินพุตต่อไปนี้ไม่ถูกต้อง

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
ช่อง
start_date

Date

วันที่ในปฏิทินช่วงเวลาทำการพิเศษนี้จะเริ่มต้น

open_time

string

เวลาจริงใน start_date เมื่อเปิดสถานที่ ซึ่งแสดงในรูปแบบขยาย ISO 8601 นาน 24 ชั่วโมง (hh:mm) ค่าที่ใช้ได้คือ 00:00-24:00 โดยที่ 24:00 หมายถึงเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ ต้องระบุหาก is_closed เป็นเท็จ

end_date

Date

วันที่ตามปฏิทินของช่วงเวลาพิเศษนี้จะสิ้นสุด หากไม่ได้ตั้งค่าช่อง end_date ค่าเริ่มต้นจะเป็นวันที่ที่ระบุใน start_date หากมีการตั้งค่า ช่องนี้ต้องเท่ากับหรือมากกว่า 1 วันหลังจาก start_date

close_time

string

เวลาจริงใน end_date เมื่อสถานที่ปิด ซึ่งแสดงในรูปแบบขยาย ISO 8601 นาน 24 ชั่วโมง (hh:mm) ค่าที่ใช้ได้คือ 00:00-24:00 โดยที่ 24:00 หมายถึงเที่ยงคืนเมื่อสิ้นสุดช่องวันที่ระบุ ต้องระบุหาก is_closed เป็นเท็จ

is_closed

bool

หากเป็น "จริง" ระบบจะไม่สนใจ end_date, open_time และ close_time และวันที่ที่ระบุใน start_date จะถือเป็นปิดสถานที่ทั้งวัน

SpecialHours

แสดงชุดระยะเวลาที่เวลาทำการของสถานที่ตั้งแตกต่างจากเวลาทำการปกติ

ช่อง
special_hour_periods[]

SpecialHourPeriod

รายการข้อยกเว้นสำหรับเวลาทำการปกติของธุรกิจ

เผ็ดร้อน

ระดับความเผ็ดของอาหาร

Enum
SPICINESS_UNSPECIFIED ไม่ได้ระบุระดับ
MILD สื่อถึงรสเผ็ดอ่อน
MEDIUM สื่อถึงรสเผ็ดปานกลาง
HOT สื่อถึงรสเผ็ดร้อน ระดับที่แซ่บที่สุด

StartUploadMediaItemDataRequest

ข้อความคำขอสำหรับ Media.StartUploadMediaItemData

ช่อง
parent

string

ชื่อทรัพยากรของตำแหน่งที่จะเพิ่มรายการสื่อนี้

TimeInterval

ช่วงเวลา (รวมค่าแรกและค่าสุดท้าย) ต้องมีทุกช่องจึงจะใช้ได้

ช่อง
start_date

Date

วันที่เริ่มต้นของระยะเวลานี้

start_time

TimeOfDay

เวลาเริ่มต้นของระยะเวลานี้

end_date

Date

วันที่สิ้นสุดของระยะเวลานี้

end_time

TimeOfDay

เวลาสิ้นสุดของระยะเวลานี้

TimePeriod

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

ช่อง
open_day

DayOfWeek

ระบุday of the week ช่วงเวลานี้จะเริ่มใน

open_time

string

เวลาในรูปแบบขยาย ISO 8601 แบบ 24 ชั่วโมง (ชช:นน) ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของวันที่ระบุ

close_day

DayOfWeek

บ่งบอกว่าเป็นวันday of the weekที่ช่วงเวลานี้จะสิ้นสุด

close_time

string

เวลาในรูปแบบขยาย ISO 8601 แบบ 24 ชั่วโมง (ชช:นน) ค่าที่ใช้ได้คือ 00:00-24:00 โดย 24:00 แทนเที่ยงคืนของตอนท้ายของวันที่ระบุ

TimeRange

ช่วงเวลา ระบบจะดึงข้อมูลในช่วงเป็นช่วงที่มีการเปิดแบบครึ่งเดียว (ซึ่งก็คือ [start_time, end_time))

ช่อง
start_time

Timestamp

การประทับเวลา Epoch สำหรับจุดเริ่มต้นของช่วง (รวม)

end_time

Timestamp

การประทับเวลา Epoch สำหรับจุดสิ้นสุดของช่วง (ไม่รวม)

TransferLocationRequest

ข้อความคำขอสำหรับ Locations.TransferLocation

ช่อง
name

string

ชื่อของสถานที่ที่จะโอน

to_account

string

ชื่อทรัพยากรบัญชีที่จะโอนสถานที่ตั้งไป (เช่น "accounts/8675309")

UpdateAccountAdminRequest

ข้อความคำขอสำหรับ AccessControl.UpdateAccountAdmin

ช่อง
name

string

ชื่อทรัพยากรของผู้ดูแลระบบที่จะอัปเดต

admin

Admin

ผู้ดูแลระบบที่อัปเดต หมายเหตุ: ฟิลด์ที่แก้ไขได้มีเพียง role ฟิลด์ ระบบจะไม่สนใจช่องอื่นๆ ทั้งหมด

UpdateAccountRequest

ข้อความคำขอสำหรับ Accounts.UpdateAccount

ช่อง
name

string

ชื่อบัญชีที่จะอัปเดต

account

Account

ข้อมูลบัญชีที่อัปเดตแล้ว หมายเหตุ: ฟิลด์ที่แก้ไขได้มีเพียง account_name ฟิลด์

validate_only

bool

หากจริง ระบบจะตรวจสอบคำขอโดยไม่อัปเดตบัญชีจริงๆ

UpdateFoodMenusRequest

ขอข้อความ FoodMenu.UpdateFoodMenus

ช่อง
food_menus

FoodMenus

ต้องระบุ ข้อมูลเมนูอาหารที่อัปเดตแล้ว ยกเลิกการตั้งค่าเมนูได้โดยการอัปเดตโดยไม่มีส่วนเมนู

update_mask

FieldMask

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

UpdateHealthProviderAttributesRequest

ข้อความคำขอสำหรับ HealthProviderAttributes.UpdateHealthProviderAttributes

ช่อง
health_provider_attributes

HealthProviderAttributes

ต้องระบุ แอตทริบิวต์ของผู้ให้บริการด้านสุขภาพที่อัปเดตแล้ว

update_mask

FieldMask

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

UpdateLocalPostRequest

ข้อความคำขอสำหรับ UpdateLocalPost

ช่อง
name

string

ชื่อโพสต์ในพื้นที่ที่จะอัปเดต

local_post

LocalPost

ข้อมูลโพสต์ในพื้นที่ที่อัปเดตแล้ว

update_mask

FieldMask

ช่องข้อมูลที่ต้องการอัปเดต คุณต้องระบุแต่ละช่องที่อัปเดตในมาสก์

UpdateLocationAdminRequest

ข้อความคำขอสำหรับ AccessControl.UpdateLocationAdmin

ช่อง
name

string

ชื่อทรัพยากรของผู้ดูแลระบบที่จะอัปเดต

admin

Admin

ผู้ดูแลระบบที่อัปเดต หมายเหตุ: ฟิลด์ที่แก้ไขได้มีเพียง role ฟิลด์ ระบบจะไม่สนใจช่องอื่นๆ ทั้งหมด

UpdateLocationRequest

ข้อความคำขอสำหรับ Locations.UpdateLocation

ช่อง
name

string

ชื่อของสถานที่ที่จะอัปเดต

location

Location

ข้อมูลตำแหน่งที่อัปเดต

update_mask

FieldMask

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

validate_only

bool

หากจริง ระบบจะตรวจสอบคำขอโดยไม่อัปเดตสถานที่ตั้งจริง

attribute_mask

FieldMask

รหัสของแอตทริบิวต์ที่จะอัปเดต เฉพาะแอตทริบิวต์ที่ระบุไว้ในมาสก์เท่านั้นที่จะได้รับการอัปเดต หากมีแอตทริบิวต์อยู่ในมาสก์และไม่ได้อยู่ในตำแหน่งนั้น ระบบจะนำแอตทริบิวต์นั้นออก มาสก์ที่ว่างเปล่าจะอัปเดตแอตทริบิวต์ทั้งหมด

เมื่อใดก็ตามที่มีการตั้งค่าช่องนี้ อัปเดต_mask ควรมีแอตทริบิวต์เป็นหนึ่งในช่องที่จะอัปเดต

UpdateMediaItemRequest

ข้อความคำขอสำหรับ Media.UpdateMediaItem

ช่อง
name

string

ชื่อรายการสื่อที่จะอัปเดต

media_item

MediaItem

รายการสื่อที่จะอัปเดต

อัปเดตได้เฉพาะหมวดหมู่หรือรหัสรายการราคาเท่านั้น

update_mask

FieldMask

ช่องข้อมูลที่ต้องการอัปเดต หากไม่ได้ระบุมาสก์ ระบบจะถือว่าเป็นการอัปเดตแบบเต็มและจะตั้งค่าช่องที่แก้ไขได้ทั้งหมดเป็นค่าที่ส่งผ่าน

UpdateNotificationsRequest

ข้อความคำขอสำหรับ Accounts.UpdateNotifications

ช่อง
name

string

ชื่อทรัพยากรการตั้งค่าการแจ้งเตือน

notifications

Notifications

การตั้งค่าการแจ้งเตือนที่อัปเดตแล้ว

UpdateQuestionRequest

ข้อความคำขอสำหรับ QuestionsAndAnswers.UpdateQuestion

ช่อง
name

string

ชื่อคำถามที่จะอัปเดต

question

Question

คำถามที่อัปเดตแล้ว

UpdateReviewReplyRequest

ข้อความคำขอสำหรับ Reviews.UpdateReviewการตอบกลับ

ช่อง
name

string

ชื่อรีวิวที่จะตอบกลับ

review_reply

ReviewReply

การตอบกลับรีวิว หากมีการตอบกลับอยู่แล้ว ข้อมูลนี้จะแทนที่การตอบกลับเก่า

UpdateServiceListRequest

อัปเดตข้อความคำขอรายการบริการ

ช่อง
service_list

ServiceList

ไม่บังคับ ข้อมูลรายการบริการที่อัปเดตแล้ว ถ้าเว้นช่องนี้ว่างไว้ API จะลบ ServiceList หากมีการตั้งค่า ServiceList ไว้ API จะแทนที่ ServiceList เดิมด้วยรายการที่กำหนดไว้

update_mask

FieldMask

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

UpsertAnswerRequest

ข้อความคำขอสำหรับ QuestionsAndAnswers.UpsertAnswer

ช่อง
parent

string

ชื่อคำถามที่จะเขียนคำตอบ

answer

Answer

คำตอบใหม่

UrlAttributeValue

ค่าของแอตทริบิวต์ที่มี URL value_type

ช่อง
url

string

URL

ValidationError

อธิบายความล้มเหลวของการตรวจสอบในคำขอไคลเอ็นต์

ช่อง
error_details[]

ErrorDetail

แสดงรายละเอียดของการตรวจสอบความถูกต้องแต่ละรายการด้วยรหัสข้อผิดพลาดจำนวนเต็ม

การยืนยัน

การยืนยันคือความพยายามในการยืนยันสถานที่

ช่อง
name

string

ชื่อแหล่งข้อมูลของการยืนยัน

method

VerificationMethod

วิธีของการยืนยัน

state

VerificationState

สถานะของการยืนยัน

create_time

Timestamp

การประทับเวลาเมื่อมีการขอการยืนยัน

VerificationState

สถานะการยืนยันที่เป็นไปได้ทั้งหมด

Enum
VERIFICATION_STATE_UNSPECIFIED ค่าเริ่มต้นจะทำให้เกิดข้อผิดพลาด
PENDING รอการยืนยัน
COMPLETED การยืนยันเสร็จสมบูรณ์แล้ว
FAILED การยืนยันล้มเหลว

VerificationMethod

ระบุกระบวนการที่ Google ใช้เพื่อยืนยันตำแหน่ง

Enum
VERIFICATION_METHOD_UNSPECIFIED ค่าเริ่มต้นจะทำให้เกิดข้อผิดพลาด
ADDRESS ส่งไปรษณียบัตรที่มี PIN ยืนยันไปยังที่อยู่ทางไปรษณีย์ที่ต้องการ PIN จะใช้เพื่อยืนยันกับ Google ให้เสร็จสมบูรณ์
EMAIL ส่งอีเมลที่มี PIN ยืนยันไปยังอีเมลที่ระบุ PIN จะใช้เพื่อยืนยันกับ Google ให้เสร็จสมบูรณ์
PHONE_CALL โทรออกโดยระบุ PIN ยืนยันไปยังหมายเลขโทรศัพท์ที่ระบุ PIN จะใช้เพื่อยืนยันกับ Google ให้เสร็จสมบูรณ์
SMS ส่ง SMS ที่มี PIN ยืนยันไปยังหมายเลขโทรศัพท์ที่ระบุ PIN จะใช้เพื่อยืนยันกับ Google ให้เสร็จสมบูรณ์
AUTO ยืนยันสถานที่โดยที่ผู้ใช้ไม่ต้องดำเนินการใดๆ เพิ่มเติม ตัวเลือกนี้อาจใช้ไม่ได้ในบางสถานที่ตั้ง

VerificationOption

ตัวเลือกการยืนยันแสดงถึงวิธียืนยันสถานที่ (ระบุโดยวิธีการยืนยัน) และตำแหน่งที่จะส่งการยืนยัน (ระบุด้วยข้อมูลที่แสดง)

ช่อง
verification_method

VerificationMethod

วิธีการยืนยันสถานที่

ช่องการรวม DisplayData หนึ่งในข้อมูลการแสดงผล ข้อมูลต้องตรงกับเมธอด เว้นว่างไว้หากเมธอดที่เกี่ยวข้องไม่มีข้อมูลการแสดงผล DisplayData ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
phone_data

PhoneVerificationData

ตั้งค่าเฉพาะในกรณีที่วิธีการคือ PHONE_CALL หรือ SMS

address_data

AddressVerificationData

ตั้งค่าเฉพาะในกรณีที่เมธอดคือ MAIL

email_data

EmailVerificationData

ตั้งค่าเฉพาะในกรณีที่วิธีการคือ EMAIL

AddressVerificationData

แสดงข้อมูลสำหรับการยืนยันผ่านไปรษณียบัตร

ช่อง
business_name

string

ชื่อธุรกิจของผู้ขาย

address

PostalAddress

ที่อยู่ที่สามารถส่งไปรษณียบัตรได้

EmailVerificationData

แสดงข้อมูลสำหรับการยืนยันทางอีเมล

ช่อง
domain_name

string

ชื่อโดเมนในอีเมล เช่น &quot;gmail.com&quot; ใน foo@gmail.com

user_name

string

ชื่อผู้ใช้ในอีเมล เช่น "foo" ใน foo@gmail.com

is_user_name_editable

bool

ลูกค้าได้รับอนุญาตให้ระบุชื่อผู้ใช้อื่นหรือไม่

PhoneVerificationData

แสดงข้อมูลสำหรับการยืนยันทางโทรศัพท์ เช่น โทรศัพท์, SMS

ช่อง
phone_number

string

หมายเลขโทรศัพท์ที่จะส่ง PIN ไปให้

VerifyLocationRequest

ข้อความคำขอสำหรับ Verifications.VerifyLocation

ช่อง
name

string

ชื่อทรัพยากรของสถานที่ที่ยืนยัน

method

VerificationMethod

วิธีการยืนยัน

language_code

string

รหัสภาษา BCP 47 ซึ่งแสดงภาษาที่ใช้สำหรับกระบวนการยืนยัน

context

ServiceBusinessContext

ข้อมูลบริบทเพิ่มเติมสำหรับการยืนยันธุรกิจที่ให้บริการ ต้องระบุสำหรับสถานที่ที่มีประเภทธุรกิจคือ CUSTOMER_LOCATION_ONLY สำหรับการยืนยัน ADDRESS เราจะใช้ที่อยู่เพื่อส่งไปรษณียบัตร สำหรับวิธีการอื่นๆ การยืนยันนี้ควรเหมือนกับวิธีการที่ส่งไปยัง Fetch VerificationOptions ระบบจะโยน INVALID_ARGUMENT ไปหากมีการตั้งค่าไว้สำหรับสถานที่ตั้งธุรกิจประเภทอื่น

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

EmailInput

อินพุตสำหรับเมธอด EMAIL

address_input

AddressInput

อินพุตสำหรับเมธอด ADDRESS

phone_input

PhoneInput

อินพุตสำหรับเมธอด PHONE_CALL/SMS

VerifyLocationResponse

ข้อความตอบกลับสำหรับ Verifications.VerifyLocation

ช่อง
verification

Verification

คำขอการยืนยันที่สร้างขึ้น