Business Information API

บันทึกการเปลี่ยนแปลง

v1alpha

การอัปเดตต่อไปนี้พร้อมใช้งานใน v1alpha

แก้ไขสถานะสำหรับสถานที่และแอตทริบิวต์

  • เพิ่ม locations.getExtended (GET /v1alpha/{name=locations/*}:getExtended) เพื่อดึงข้อมูล ExtendedLocation ซึ่งรวมถึง Location (locationProvidedByMerchant) ที่ผู้ขายระบุ, Location (locationSeenByConsumers) สำหรับผู้บริโภค และการแมปชื่อช่องระดับบนสุดกับ ExtendedFieldData
  • เพิ่ม locations.attributes.getExtended (GET /v1alpha/{name=locations/*/attributes}:getExtended) เพื่อดึงข้อมูล ExtendedAttributes ซึ่งจับคู่ attributeProvidedByMerchant และ attributeSeenByConsumers กับ ExtendedFieldData สำหรับแต่ละแอตทริบิวต์
  • เพิ่ม ExtendedFieldData เพื่อให้ข้อมูลเมตาการแก้ไขต่อช่องและต่อแอตทริบิวต์ ซึ่งรวมถึงEditLifecycleStage (เช่น EDIT_LIFECYCLE_STAGE_PENDING หรือ EDIT_LIFECYCLE_STAGE_REJECTED) เหตุผลในการปฏิเสธ PolicyViolation การแก้ไขล่าสุด updateTime และแหล่งที่มาของการแก้ไข Source (SOURCE_API, SOURCE_UI)
  • ดูตัวอย่างการใช้งานได้ที่ตรวจสอบสถานะการแก้ไขสถานที่และแอตทริบิวต์

v1

การเข้าถึง API

คุณจะต้องเปิดใช้ Business Information API จากคอนโซล GCP ขอบเขต OAuth ยังคงเหมือนเดิม

URL ปลายทาง

ปลายทางสำหรับการค้นหาข้อมูลทางธุรกิจ แอตทริบิวต์ หมวดหมู่ เครือ และสถานที่ตั้งทั้งหมดจะเข้าถึงได้ที่ https://mybusinessbusinessinformation.googleapis.com/v1/ แทน https://mybusiness.googleapis.com/v4/

ชื่อเส้นทางสำหรับปลายทางของสถานที่ตั้งเปลี่ยนจาก accounts/accountId/locations/locationId เป็น locations/locationId

การอัปเดตตำแหน่ง

  • locationName เปลี่ยนชื่อเป็น title แล้ว
  • websiteUrl เปลี่ยนชื่อเป็น websiteUri แล้ว
  • ตอนนี้ accounts.locations.list และ locations.get ต้องใช้ readMask
  • ตอนนี้ primaryPhone และ additionalPhones เป็นส่วนหนึ่งของ PhoneNumbers แล้ว
  • ตอนนี้ primaryCategory และ additionalCategories เป็นส่วนหนึ่งของหมวดหมู่แล้ว
  • address เปลี่ยนชื่อเป็น storefrontAddress แล้ว
  • accounts.locations.clearAssociation ได้รับการอัปเดตเป็น locations.clearLocationAssociation แล้ว
  • ตอนนี้ระบบจะอ่านและอัปเดตserviceItemsจากออบเจ็กต์ Location โดยตรง

Attributes

  • ออบเจ็กต์ Attributes ใหม่และปลายทาง locations.attributes.getGoogleUpdated ที่เกี่ยวข้องเพื่อรับเวอร์ชันที่อัปเดตจาก Google
  • attributes.list มีพารามิเตอร์ show_all ที่ช่วยให้ลูกค้าเห็นแอตทริบิวต์ต่างๆ ทั้งหมดที่ตั้งค่าไว้สำหรับชุดค่าผสมหมวดหมู่และภูมิภาคหนึ่งๆ ได้

ธุรกิจที่ให้บริการตามสถานที่

  • ธุรกิจประเภท CUSTOMER_LOCATION_ONLY ไม่จำเป็นต้องกรอกที่อยู่อีกต่อไป
  • การเพิ่ม regionCode ใน ServiceAreaBusiness ต้องตั้งค่าสำหรับธุรกิจประเภท CUSTOMER_LOCATION_ONLY

ปลายทางและออบเจ็กต์ที่เลิกใช้งานแล้ว

  • การนำวัตถุ LocationKey รายการออก ระบบได้ย้ายช่องที่มีอยู่ไปยังข้อมูลเมตาแล้ว
  • การนำวัตถุ PriceLists รายการออก โดยแทนที่ด้วย FoodMenus และ ServiceLists
  • การนำวัตถุ LocationState รายการออก ช่องที่มีอยู่ส่วนใหญ่ได้ย้ายไปที่ข้อมูลเมตาแล้ว แม้ว่า Metadata จะมีบูลีนเพื่อดูว่าผู้ขายควบคุมธุรกิจได้อย่างเต็มรูปแบบหรือไม่ (เสียงของผู้ขาย) แต่ฟิลด์ที่เกี่ยวข้องกับการระงับและการยืนยันที่มีรายละเอียดมากขึ้นได้ย้ายไปยัง Verifications API แล้ว ใช้เมธอด locations.getVoiceOfMerchantState สำหรับขั้นตอนถัดไปเพื่อรับ Voice of Merchant
  • เลิกใช้งานปลายทาง googleLocations.report และ accounts.locations.findMatchingLocations แล้ว
  • ย้ายปลายทาง TransferLocation ไปยัง locations.transfer ใน Account Management API แล้ว