บันทึกประจำรุ่น API สำหรับบัญชีผู้ขาย

สัปดาห์ที่ 1 ก.ค. 2025

• เปิดตัวทรัพยากร CheckoutSettings ซึ่งอนุญาตให้ผู้ใช้ API สร้าง อัปเดต ลบ รับ checkoutSettings

สัปดาห์ที่ 26 พฤษภาคม 2025

• ตอนนี้คุณกรองบัญชีตาม capabilities ได้แล้ว ปัจจุบันค่าที่เป็นไปได้มีเพียง CAN_UPLOAD_PRODUCTS ตัวกรองนี้ช่วยให้คุณดึงข้อมูล บัญชีที่อัปโหลดผลิตภัณฑ์ได้ ซึ่งหมายความว่าตอนนี้คุณใช้ข้อความต่อไปนี้ที่ระดับบัญชีได้แล้ว

  • capabilities:CAN_UPLOAD_PRODUCTS
  • -capabilities:CAN_UPLOAD_PRODUCTS
  • NOT capabilities:CAN_UPLOAD_PRODUCTS ดูข้อมูลเพิ่มเติมได้ที่ คู่มือการกรอง

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

สัปดาห์ของวันที่ 19 พฤษภาคม 2025

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

สัปดาห์ที่ 12 พฤษภาคม 2025

• เปิดตัวแหล่งข้อมูลนโยบายคืนสินค้าออนไลน์ซึ่งอนุญาตให้ผู้ใช้ API สร้าง อัปเดต และลบนโยบายคืนสินค้า
• เปิดตัว OmnichannelSettingsService และทรัพยากร OmnichannelSetting ซึ่ง ช่วยให้ผู้ใช้ API จัดการประสบการณ์การเข้าถึงลูกค้าจากทุกช่องทาง (Omnichannel) ได้
• เปิดตัว LfpProvidersService และทรัพยากร LfpProvider ซึ่งช่วยให้ผู้ใช้ API จัดการความสัมพันธ์ในการเป็นพาร์ทเนอร์ฟีดในพื้นที่ได้
• เปิดตัว GbpAccountsService และทรัพยากร GbpAccount ซึ่งช่วยให้ผู้ใช้ API จัดการ Google Business Profile ได้
  • เปิดใช้ประเภทบริการ LocalListingManagement ใน AccountService ซึ่งจะลิงก์ กลุ่มธุรกิจที่ใช้สำหรับโฆษณาสินค้าคงคลังในร้านหรือข้อมูลในร้านที่แสดงฟรี

สัปดาห์ของวันที่ 28 เม.ย. 2025

• เปิดตัวทรัพยากร AccountService และ AccountRelationship ซึ่งช่วยให้ผู้ใช้ API จัดการความสัมพันธ์และสร้างบริการให้กับผู้ให้บริการได้

สัปดาห์ที่ 14 เม.ย. 2025

• ตอนนี้ TermsOfServiceService.AcceptTermsOfService จะแสดงผล TermsOfServiceAgremeentState ที่ได้รับการยอมรับซึ่งรวมอยู่ในประเภทการตอบกลับ

• ตอนนี้กริยาของการดำเนินการ TermsOfServiceService.AcceptTermsOfService คือ POST (เดิมคือ GET)

• ชี้แจงว่าต้องเรียกใช้ AccountsService.ListSubAccounts โดยใช้รูปแบบ accounts/... (ไม่ใช่ providers/...) เพื่อหลีกเลี่ยงไม่ให้วิธีนี้ อยู่นอกขอบเขตของ accounts (ซึ่งหมายถึง GET accounts/123:listSubAccounts ไม่ใช่ GET providers/123:listSubAccounts)

สัปดาห์ที่ 31 มี.ค. 2025

• สําหรับการกรองบัญชี เราได้ประกาศเลิกใช้งานตัวกรอง externalAccountId ในสัปดาห์ที่ 2 ธ.ค. 2024 และตอนนี้ตัวกรองนี้ไม่พร้อมใช้งานแล้ว ซึ่งหมายความว่าตอนนี้คุณจะกรองตาม externalAccountId ได้ที่ระดับ service เท่านั้น ตัวกรอง เช่น relationship(externalAccountId = "foo") จะใช้งานไม่ได้อีกต่อไปและ ต้องแสดงเป็น relationship(service(externalAccountId = "foo"))

• ชี้แจงในเอกสารประกอบ AccountsService ว่าไม่สามารถสร้างบัญชีแบบสแตนด์อโลนได้

สัปดาห์ของวันที่ 3 มี.ค. 2025

- เราได้ปรับโครงสร้างaccounts.onlineReturnPolicies#SeasonalOverride เพื่อเพิ่มความชัดเจนและความสอดคล้องกัน การอัปเดตเหล่านี้รวมถึง

• การเปลี่ยนชื่อฟิลด์:
  • begin เปลี่ยนชื่อเป็น start_date แล้ว
  • end เปลี่ยนชื่อเป็น end_date แล้ว
• การนำฟิลด์ออก
  • ระบบได้นำฟิลด์ policy ที่เลิกใช้งานแล้วออก

- นักพัฒนาแอปควรอัปเดตโค้ดให้สอดคล้องกับการเปลี่ยนแปลงเหล่านี้

เปิดตัวบริการ AutomaticImprovements ที่คุณใช้จัดการสิ่งต่อไปนี้ได้

• การอัปเดตสินค้า
• การปรับปรุงรูปภาพ
• การปรับปรุงการจัดส่ง

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเปิดใช้การปรับปรุงอัตโนมัติ

สัปดาห์ที่ 17 ก.พ. 2025

นำเพรดิเคต callerHasAccessToProviderFilter() ออกจากตัวกรองบัญชี

สัปดาห์ที่ 10 ก.พ. 2025

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

• เพิ่มกำหนดเวลาเริ่มต้น 10 นาทีสำหรับเมธอด RPC ทั้งหมด

• เพิ่มรายการชื่อโปรแกรมที่พร้อมใช้งานลงใน accounts.programs คำอธิบายทรัพยากร

• User.accessRights ตอนนี้เป็น REQUIRED ซึ่งส่งผลต่อทั้งเมธอด UserService.Create และ AccountsService.CreateAndConfigure

สัปดาห์ที่ 27 ม.ค. 2025

AccountsService.ListAccounts (และแบบทรานซิทีฟ AccountsService.ListSubAccounts) จะแสดงผลบัญชีในลักษณะที่สอดคล้องกันในที่สุด แทนที่จะเป็นการอ่านที่สอดคล้องกันอย่างเข้มงวด

สัปดาห์ที่ 20 ม.ค. 2025

ระบบเลิกใช้งานฟิลด์ users ของ CreateAndConfigureAccountRequest แล้ว เพื่อใช้ user ใหม่แทน CreateUserRequest ที่อ้างอิงมีฟิลด์ parent ซึ่งไม่จำเป็นในบริบทของ CreateAndConfigureAccountRequest

สัปดาห์ที่ 6 ม.ค. 2025

ตอนนี้ระบบได้ทำเครื่องหมายฟิลด์ user ของข้อความ CreateUserRequest เป็น OPTIONAL อย่างถูกต้องแล้ว

ตอนนี้ระบบจะป้อนข้อมูลในช่อง domain ในข้อผิดพลาดที่ส่งคืนด้วย merchantapi.googleapis.com แทน global

สัปดาห์ที่ 2 ธ.ค. 2024

สำหรับการกรองบัญชี ระบบจะย้ายเพรดิเคต externalAccountId ไปยังระดับ service จากระดับ relationship ดังนั้น ตอนนี้ตัวกรอง relationship(externalAccountId = "foo") จะต้องเขียนเป็น relationship(service(externalAccountId = "foo")) เรายังคงรองรับรูปแบบเดิม เพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้ แต่จะเลิกใช้งานและจะแสดง ข้อผิดพลาดในอนาคตอันใกล้นี้ เอกสารทั้งหมดจะกล่าวถึงเฉพาะรูปแบบใหม่

สัปดาห์ที่ 18 พ.ย. 2024

ตอนนี้ผู้ให้บริการในฟิลด์ CreateAndConfigureAccountRequest.service.provider อาจเป็นหนึ่งใน providers/GOOGLE_ADS หรือ providers/GOOGLE_BUSINESS_PROFILE ก็ได้ บัญชีอื่นๆ ควรเรียกว่า providers/123 (ไม่ใช่ accounts/123) ซึ่งหมายความว่าระบบจะไม่ ทำเครื่องหมายฟิลด์เป็นข้อมูลอ้างอิงบัญชีอีกต่อไป อย่างไรก็ตาม คุณยังคง ใช้ชื่อบัญชี เช่น accounts/123 เพื่อให้เข้ากันได้แบบย้อนหลังได้

ตอนนี้ผู้ให้บริการใน ListSubAccountsRequest ควรอยู่ในรูปแบบ providers/123 แต่เพื่อให้เข้ากันได้แบบย้อนหลัง คุณจะยังใช้ accounts/123 ได้

สัปดาห์ที่ 4 พฤศจิกายน 2024

ทำเครื่องหมาย promotions_consent REQUIRED (จาก OPTIONAL) ใน BusinessIdentity resource ซึ่งจะมีผลกับวิธีการอัปเดตเท่านั้น เพื่อชี้แจงว่าไม่สามารถอัปเดต promotions_consent เป็น UNSPECIFIED ได้ ซึ่งก่อนหน้านี้ก็ทำไม่ได้อยู่แล้ว แต่ตอนนี้ข้อผิดพลาดจะอธิบายได้ชัดเจนมากขึ้นและมีการใส่คำอธิบายประกอบฟิลด์อย่างถูกต้อง

สัปดาห์ที่ 28 ตุลาคม 2024

ปรับปรุงเอกสารประกอบของแหล่งข้อมูลต่างๆ ของ API ย่อยของบัญชี เช่น User, Homepage, BusinessInfo เป็นต้น

สัปดาห์ที่ 21 ตุลาคม 2024

ปรับปรุงเอกสารประกอบของฟิลด์ update_mask ในคำขออัปเดตตลอดจนระบุฟิลด์ที่รองรับการอัปเดตโดยเฉพาะ

เพิ่มลิงก์ศูนย์ช่วยเหลือของ Google Business สำหรับผู้ให้บริการที่รองรับไปยังเอกสารภายนอกของแหล่งข้อมูล ShippingSettings

สัปดาห์ที่ 14 ตุลาคม 2024

ทำเครื่องหมาย provider เป็น REQUIRED ใน AccountsService.CreateAndConfigureAccountRequest.AddAccountService

ทําให้ update_mask เป็นตัวเลือกใน Sub-API ของบัญชี (เช่น ข้อมูลระบุตัวตนทางธุรกิจ ข้อมูลทางธุรกิจ หน้าแรก ฯลฯ) และย้อนหลังสําหรับแหล่งข้อมูล ConversionSources

เพิ่มพารามิเตอร์ overwrite ไปยัง ClaimHomepageRequest แล้ว

สัปดาห์ที่ 30 กันยายน 2024

เปิดตัวพารามิเตอร์ "force" สำหรับเมธอด "Accounts.delete"

สัปดาห์ที่ 23 กันยายน 2024

ทำเครื่องหมาย region_code และ kind เป็น REQUIRED ใน RetrieveLatestTermsOfServiceRequest

สัปดาห์ที่ 16 กันยายน 2024

เปลี่ยนประเภทพารามิเตอร์ time_zone เป็นสตริงใน ListAccountIssuesRequest

สัปดาห์ที่ 12 ส.ค. 2024

เพิ่มฟิลด์ korean_business_registration_number ลงในBusinessInfo แหล่งข้อมูลแล้ว

สัปดาห์ที่ 27 พฤษภาคม 2024

เปิดตัว Accounts Sub-API เวอร์ชันเบต้า