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

v4.9

ฟีเจอร์ใหม่

MoreHours
คุณตั้งค่า MoreHours เป็นส่วนหนึ่งของข้อมูลธุรกิจได้แล้ว
คุณเรียกข้อมูล MoreHourTypes สำหรับหมวดหมู่แต่ละหมวดหมู่ได้โดยใช้ categories.batchGet

การเปลี่ยนแปลงด้านพฤติกรรม

การเลิกใช้งานบัญชี v4.x
accounts, accounts.admins, accounts.invitations และ accounts.locations.admins จะเลิกใช้งานใน Google My Business API แล้ว โปรดดูข้อมูลเพิ่มเติมที่บันทึกการเปลี่ยนแปลงการเลิกใช้งาน
โพสต์คำกระตุ้นการตัดสินใจ
ในไตรมาสที่ 2 ปี 2021 CallToAction โพสต์ที่มี GET_OFFER ActionType จะใช้ไม่ได้อีกต่อไป

v4.8

ฟีเจอร์ใหม่

สิ่งอำนวยความสะดวกของที่พัก
ข้อมูลและการอัปเดตสิ่งอำนวยความสะดวกของที่พัก ข้อมูลเพิ่มเติม
การเพิ่มปลายทาง GetGoogleUpdated สำหรับที่พัก
การเพิ่มค่าบูลีน canOperateLodgingData ใน LocationState
แอตทริบิวต์ผู้ให้บริการด้านสุขภาพ
การดึงข้อมูลและการอัปเดตของ HealthProviderAttributes ข้อมูลเพิ่มเติม
การเพิ่มค่าบูลีน canOperateHealthData ใน LocationState
เครือข่ายการประกันภัย
แสดงเครือข่ายการประกันที่สถานที่ตั้งยอมรับ ข้อมูลเพิ่มเติม

การเปลี่ยนแปลงด้านพฤติกรรม

รหัสการตรวจสอบ
รหัสรีวิวย้ายข้อมูลไปยังรูปแบบใหม่แล้ว ตอนนี้รหัสใหม่นี้จะส่งกลับมาในการตอบกลับจาก API ทั้งหมดที่เกี่ยวข้อง รหัสรีวิวเดิมจะยังคงได้รับการแก้ไขเมื่อเรียกใช้ API เป็นระยะเวลาสั้นๆ แต่คุณจะต้องรีเฟรชรหัสรีวิวทั้งหมดที่เก็บไว้ในระบบภายใน 30 วันตามนโยบายของเรา โดยเรียกใช้ปลายทาง listReviews
ธุรกิจที่ให้บริการตามสถานที่
ในไตรมาสที่ 1 ปี 2021 จะไม่มีการส่ง Address ในออบเจ็กต์ Location สําหรับธุรกิจ CUSTOMER_LOCATION_ONLY อีกต่อไป

v4.7

ฟีเจอร์ใหม่

เมนูอาหาร
การดึงข้อมูลและการอัปเดตของ Food Menus ข้อมูลเพิ่มเติม

v4.6

ฟีเจอร์ใหม่

รายการบริการ
คุณเรียกข้อมูลและอัปเดตบริการที่ธุรกิจเสนอได้แล้ว ข้อมูลเพิ่มเติม
การเพิ่มค่าบูลีน canModifyServiceList ใน LocationState
ระบุว่าสถานที่มีสิทธิ์แก้ไขรายการบริการหรือไม่ข้อมูลเพิ่มเติม
ServiceTypes ที่กำหนดไว้ล่วงหน้าสำหรับหมวดหมู่
ตอนนี้ประเภทบริการที่กำหนดไว้ล่วงหน้ารวมอยู่ในออบเจ็กต์หมวดหมู่แล้วข้อมูลเพิ่มเติม
CategoryView
ความสามารถในการระบุข้อมูลพร็อพเพอร์ตี้ BASIC หรือ FULL สำหรับหมวดหมู่ มุมมอง FULL จะแสดงรายละเอียดเพิ่มเติม เช่น ประเภทบริการ ข้อมูลเพิ่มเติม
Category.BatchGet เมธอด
วิธีการใหม่นี้จะทำให้คุณป้อนข้อมูลรายการหมวดหมู่และแสดงข้อมูลเฉพาะในหมวดหมู่เหล่านั้นได้ ข้อมูลเพิ่มเติม

อัปเดตเกี่ยวกับโควิด-19 เวอร์ชัน 4.5 2

ฟีเจอร์ใหม่

ประเภทโพสต์แจ้งเตือนเกี่ยวกับโควิด-19
ตอนนี้คุณสร้างโพสต์ COVID_19 ผ่าน API ได้แล้ว ข้อมูลเพิ่มเติม

อัปเดตเกี่ยวกับโควิด-19 เวอร์ชัน 4.5 1

ฟีเจอร์ใหม่

ปิดชั่วคราว
คุณสามารถตั้งค่าธุรกิจเป็น CLOSED_TEMPORARILY ผ่าน API ได้แล้ว ข้อมูลเพิ่มเติม

v4.5

ฟีเจอร์ใหม่

Pub/Sub สำหรับช่วงถามและตอบ
ตอนนี้คุณรับการแจ้งเตือน Google Cloud Pub/Sub สำหรับคำถามและคำตอบใหม่/ที่อัปเดตในสถานที่ตั้งได้แล้ว ข้อมูลเพิ่มเติม
Pub/Sub สำหรับสถานะรายการ
ตอนนี้คุณรับการแจ้งเตือนจาก Google Cloud Pub/Sub เกี่ยวกับการเปลี่ยนแปลงสถานะข้อมูลได้แล้ว ข้อมูลเพิ่มเติม

v4.4

ฟีเจอร์ใหม่

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

การเปลี่ยนแปลงลักษณะการทำงาน

ตั๋วแบบไม่ระบุวัน
ตอนนี้คุณกำหนดวันที่เปิดในอนาคตให้กับข้อมูลได้แล้ว
PointRadius
PointRadius ตอนนี้เป็นแบบอ่านอย่างเดียว การแก้ไขหรือสร้างธุรกิจที่ให้บริการในพื้นที่จะต้องใช้ Places

v4.3

ฟีเจอร์ใหม่

API คำถามและคำตอบ
ดึงข้อมูลคำถาม โพสต์คำตอบ และคำถามที่พบบ่อยเกี่ยวกับที่ตั้งธุรกิจ ข้อมูลเพิ่มเติม
อ่านรีวิวจำนวนมาก
เรียกข้อมูลรีวิวสำหรับสถานที่หลายแห่งได้ในสายเดียว ข้อมูลเพิ่มเติม
สถานที่ตั้ง Google ที่แนะนำ
ดูสถานที่ที่ไม่ได้อ้างสิทธิ์ซึ่ง Google คิดว่าอาจเป็นของคุณ ข้อมูลเพิ่มเติม
รายงานปัญหาเกี่ยวกับ GoogleLocation
รายงานปัญหาเกี่ยวกับผลลัพธ์ของ RecommendedGoogleLocations หรือ GoogleLocations ข้อมูลเพิ่มเติม
Enum บริการสำหรับ PriceList ส่วน
ระบุว่าส่วน PriceList มีรายการอาหารหรือบริการที่มีให้ ข้อมูลเพิ่มเติม
คำอธิบายสื่อ
ใส่คำบรรยายเมื่ออัปโหลดสื่อใหม่ ข้อมูลเพิ่มเติม
ข้อมูลเชิงลึก CHAINS_QUERIES
ดึงข้อมูลจำนวนครั้งที่สถานที่แสดงขึ้นอันเป็นผลจากการค้นหาเครือธุรกิจนั้นๆ ข้อมูลเพิ่มเติม

การเปลี่ยนแปลงลักษณะการทำงาน

การแจ้งเตือนสำหรับบัญชีขององค์กรและกลุ่มสถานที่ตั้ง
บัญชีที่กำหนดค่าสำหรับการแจ้งเตือน Pub/Sub จะได้รับการแจ้งเตือนเหล่านั้นสำหรับข้อมูลใดๆ ที่อยู่ในบัญชีขององค์กรหรือกลุ่มสถานที่ตั้งที่ผู้ดูแลระบบเป็นผู้ดูแลด้วย
ListLocations สำหรับบัญชีขององค์กรและกลุ่มสถานที่ตั้ง
ตอนนี้
accounts.locations.list ที่เรียกด้วยกลุ่มผู้ใช้หรือบัญชีขององค์กรจะแสดงสถานที่ตั้งทั้งหมดที่บัญชีนั้นเข้าถึงได้

v4.2

ฟีเจอร์ใหม่

API การยืนยัน
แสดงรายการและทริกเกอร์วิธีการยืนยันที่ใช้ได้สำหรับสถานที่ที่ยังไม่ได้ยืนยัน ข้อมูลเพิ่มเติม
API ของ GoogleLocations
ค้นหาสถานที่ที่มีอยู่ใน Google เพื่ออ้างสิทธิ์หรือเรียกข้อมูลลิงก์เพื่อขอสิทธิ์เข้าถึงสถานที่ที่อ้างสิทธิ์ ข้อมูลเพิ่มเติม
ตัวกรองตำแหน่งที่ขยาย
ตัวเลือกเพิ่มเติมสำหรับการจำกัดผลลัพธ์ที่ได้จากการเรียกใช้ Locations.List ข้อมูลเพิ่มเติม
การเป็นสมาชิกเชน
ระบุว่าสถานที่หนึ่งๆ เป็นสมาชิกของเครือธุรกิจ (เช่น Walmart, Target ฯลฯ) ข้อมูลเพิ่มเติม
ข้อมูลองค์กร
ตอนนี้ข้อมูลสำหรับบัญชีขององค์กรจะแสดงเป็นส่วนหนึ่งของออบเจ็กต์บัญชี ข้อมูลเพิ่มเติม
รูปโปรไฟล์ของผู้รีวิว
ตอนนี้ URL สำหรับรูปโปรไฟล์ของผู้รีวิวได้รวมอยู่ในออบเจ็กต์รีวิวแล้ว ข้อมูลเพิ่มเติม

v4.1

ฟีเจอร์ใหม่

สื่อที่ลูกค้าระบุ
ตอนนี้คุณสามารถเรียกดูและดูข้อมูลเชิงลึกของรูปภาพและวิดีโอที่ผู้ใช้สร้างขึ้นสำหรับสถานที่ที่คุณเป็นเจ้าของและจัดการได้แล้ว ข้อมูลเพิ่มเติม
API การจัดการสำหรับผู้ดูแลระบบ
ตอนนี้คุณแสดง ยอมรับ และปฏิเสธคำเชิญที่เกี่ยวข้องกับบัญชีและสถานที่ตั้งสำหรับบัญชีได้แล้ว ข้อมูลเพิ่มเติม
Profile (คำอธิบายที่ผู้ขายระบุ)
อธิบายธุรกิจด้วยเสียงของคุณเอง และบอกให้ผู้ใช้ทราบถึงเรื่องราวเฉพาะตัวของธุรกิจและข้อเสนอของคุณ ข้อมูลเพิ่มเติม
ช่อง openingDate
ระบุวันที่ที่สถานที่เปิดธุรกิจ ข้อมูลเพิ่มเติม
โพสต์ประเภทข้อเสนอ
Post on Google รูปแบบใหม่ที่ช่วยให้ผู้ใช้ค้นพบดีลที่มีในสถานที่ของคุณ ข้อมูลเพิ่มเติม

v4

ฟีเจอร์ใหม่

โพสต์ใน Google
ตอนนี้คุณสร้าง Posts on Google โดยตรงผ่าน API ได้แล้ว
อัปโหลดภาพ
นอกเหนือจากการอัปโหลด URL ที่มีอยู่แล้ว คุณจะอัปโหลดรูปภาพผ่าน API ได้โดยตรง
การกรอง/เลือกใช้การแจ้งเตือน
ตอนนี้คุณกรองได้แล้วว่าจะให้ระบบส่งการแจ้งเตือนใดไปยังหัวข้อ PubSub การแจ้งเตือนในอนาคตจะใช้กลไกนี้เพื่อเลือกรับแทนการส่งไปยังผู้ใช้ทั้งหมด
UPDATED_REVIEW การแจ้งเตือน
ตอนนี้คุณสมัครรับข้อมูลอัปเดตเกี่ยวกับรีวิวของลูกค้าแบบเรียลไทม์ได้แล้ว
การสนับสนุนสำหรับกลุ่มผู้ใช้
Google My Business API รองรับบัญชีประเภทกลุ่มผู้ใช้แล้ว

การเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง

  • Photos ซึ่งก่อนหน้านี้เป็นช่องของออบเจ็กต์ location เปลี่ยนเป็นทรัพยากรภายใต้ตำแหน่ง (accounts/account_ID/locations/location_ID/photos) แล้ว

  • ช่องที่อยู่ Country เปลี่ยนเป็น region_code และ sub_locality เปลี่ยนเป็น sublocality

  • นำช่อง Ownership ที่เลิกใช้งานแล้วออกก่อนหน้านี้

  • ก่อนหน้านี้เจ้าของร่วมของบัญชีและสถานที่แยกแยะจากเจ้าของหลักผ่าน API ไม่ได้ (ทั้งหมดจะปรากฏเป็น OWNER) ตอนนี้เจ้าของหลักจะได้รับบทบาท OWNER และเจ้าของรายอื่นๆ จะได้รับบทบาท CO_OWNER

  • AccountType.BUSINESS เปลี่ยนชื่อเป็น AccountType.LOCATION_GROUP แล้ว

  • เมื่อใช้มาสก์ของช่องสำหรับการอัปเดตตำแหน่ง ให้ระบุ update_mask แทน field_mask ที่มีอยู่

  • ข้อความหมวดหมู่ที่ใช้สำหรับ primary_category และ additional_categories ไม่มีแบบฟอร์มที่มนุษย์อ่านได้แล้ว ผู้ใช้ควรใช้บริการหมวดหมู่ของ Google My Business API เพื่อรับชื่อหมวดหมู่ที่แปลแล้วซึ่งมนุษย์อ่านเข้าใจได้

v3.3

ฟีเจอร์ใหม่

เมนูแบบมีโครงสร้าง

ตอนนี้คุณสามารถเพิ่ม อัปเดต หรือลบรายการต่อไปนี้

  • หลายเมนูในตำแหน่งที่ระบุ

  • รวมส่วนเมนูหลายรายการไว้ในเมนู

  • แสดงรายการในเมนูพร้อมชื่อ คำอธิบาย ราคา และรูปภาพ

v3.2

ฟีเจอร์ใหม่

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

การเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง

  • ช่อง languageCodes และ platforms ของ UrlAttributeValue ซึ่งไม่มีการใช้งานก่อนหน้านี้ถูกนำออกแล้ว

  • SAME ใน enum ที่เลิกใช้งานแล้วจะนำมาใช้ก็ต่อเมื่อสถานที่ที่ซ้ำนี้มีเจ้าของหลักรายเดียวกัน ซึ่งก่อนหน้านี้ ลักษณะการทำงานนี้จะอิงตามการคำนวณการเป็นเจ้าของที่ซับซ้อนกว่าปกติ

v3.1

ฟีเจอร์ใหม่

การแจ้งเตือน
ตอนนี้คุณสมัครรับการแจ้งเตือนแบบเรียลไทม์สำหรับรีวิวใหม่ๆ ได้แล้ว
URL ของ Maps
URL ของ Google Maps จะรวมอยู่ในการตอบกลับตามสถานที่ ซึ่งจะช่วยให้ผู้ใช้ลิงก์กับ Google Maps ได้อย่างง่ายดาย
สถานะของสถานที่ตั้ง
สถานะของตำแหน่งเพิ่มเติมซึ่งระบุเวลาที่ข้อมูลได้รับการเผยแพร่ ปิดใช้อยู่ หรือรอดำเนินการยืนยัน
เปิดการแจ้งว่าไม่เหมาะสมอีกครั้ง
ธง
canReopen บ่งชี้ถึงสถานที่ที่ปิดถาวรซึ่งสามารถเปิดใหม่ได้ เทียบกับสถานที่ที่ไม่สามารถเปิดได้
Attributes
การรองรับแอตทริบิวต์ URL และ Enum
ปลายทางของหมวดหมู่
ดูรายการหมวดหมู่ที่รองรับตามประเทศและภาษา (แทนที่ไฟล์ CSV)

v3

ฟีเจอร์ใหม่

รีวิว
คุณเรียกดูและตอบกลับรีวิวธุรกิจผ่าน API ได้แล้ว
Attributes
ให้ข้อมูลเพิ่มเติมเฉพาะหมวดหมู่เกี่ยวกับสถานที่
ค้นหาสถานที่ที่ตรงกัน
ค้นหาและเชื่อมโยงสถานที่ตั้งในแผนที่กับที่ตั้งธุรกิจด้วยตนเอง
โอนสถานที่
การดำเนินการใหม่ใน Location :transfer อนุญาตให้โอนสถานที่จากบัญชีหนึ่ง (ธุรกิจหรือส่วนบุคคล) ไปยังบัญชีอื่น
รูปภาพที่ต้องการ
ระบุรูปภาพที่คุณต้องการให้ปรากฏเป็นอันดับแรกใน Google Maps และ Search
ตัวกรองการค้นหาใหม่
ตัวกรองการค้นหาใหม่ ได้แก่ any_google_updates, is_suspended และ is_duplicate
สถานะตำแหน่งใหม่
ขณะนี้รัฐต่างๆ ในสถานที่ตั้งต่างๆ รวม is_verified และ needs_reverification ไว้ด้วย
การปรับปรุง URL ของรูปภาพ
ตอนนี้ API ยอมรับ URL ของรูปภาพที่ไม่มีคำต่อท้ายรูปแบบรูปภาพแล้ว

การเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง

  • ขณะนี้สามารถอัปเดตรูปภาพได้เฉพาะสำหรับสถานที่ที่มี Google+ เพจเท่านั้น (มีการยอมรับและเลิกแสดงไปก่อนแล้ว)

  • ขณะนี้ช่อง location_name และ category_name เป็นเอาต์พุตเท่านั้น ใช้รหัสหมวดหมู่เมื่อตั้งค่าหมวดหมู่เท่านั้น

  • มาสก์ของช่องต้องไม่มีคำนำหน้า location. สำหรับช่องที่รวมอยู่อีกต่อไป

  • ตอนนี้การดำเนินการสร้าง/อัปเดตจะใช้ตำแหน่งดังกล่าวเป็นเพย์โหลดเนื้อหา ส่วนพารามิเตอร์อื่นๆ จะย้ายไปยังสตริงการค้นหา

v2

การเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง

  • คุณต้องระบุ request_id ในการเรียก CreateLocation รหัสนี้ต้องไม่ซ้ำกันสำหรับสถานที่แต่ละแห่ง ซึ่งจะช่วยป้องกันไม่ให้มีการสร้างสถานที่ที่ซ้ำกันในบัญชีของคุณ การพยายามสร้างสถานที่ซึ่งรหัสคำขอตรงกับสถานที่ที่สร้างไว้ก่อนหน้านี้ เพียงส่งคืนสถานที่ที่มีอยู่นั้น และหลีกเลี่ยงการสร้างสถานที่ซ้ำในบัญชีของคุณ

    • business_hours ใน ตำแหน่ง ถูกเปลี่ยนชื่อเป็น regular_hours