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

สัปดาห์ของวันที่ 26 ตุลาคม 2026

• อธิบายเอกสารประกอบสำหรับเมธอด accounts.homepage.unclaim และช่อง claimed ของทรัพยากร Homepage หากบัญชีรับค่าการอ้างสิทธิ์หน้าแรกจากบัญชีขั้นสูง unclaim จะแสดงการตอบกลับว่าสำเร็จ แต่หน้าแรกจะยังคงมีการอ้างสิทธิ์อยู่ หากบัญชีได้รับการยกเว้นจากการอ้างสิทธิ์ unclaim จะแสดงข้อผิดพลาด FAILED_PRECONDITION

สัปดาห์ของวันที่ 28 กันยายน 2026

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

• เพิ่มช่อง home_page_uri แบบอ่านอย่างเดียวลงในทรัพยากร accounts เพื่อแสดงผล URI ของหน้าแรกของร้านค้า

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

• เพิ่ม "ucp_checkout_management" เป็นประเภทบริการลงในทรัพยากรบริการของบัญชี หมายเหตุ: การชำระเงินด้วย UCP เป็นฟีเจอร์ที่มีการจำกัดการเข้าถึง
• เพิ่มการรองรับโปรแกรม "ucp-integration" (การเข้าถึงแบบจำกัด)
• เพิ่มการรองรับประเภทข้อกำหนดในการให้บริการ "ucp_integration"

สัปดาห์ของวันที่ 29 มิถุนายน 2026

• เปิดตัวตัวกรอง access ที่ใช้ในปลายทางของรายการบัญชี ฟีเจอร์นี้ช่วยให้คุณกรองบัญชีตามระดับการเข้าถึงได้ โดยค่าที่เป็นไปได้คือ DIRECT, INDIRECT และ ALL ลักษณะการทำงานเริ่มต้นคือการแสดงบัญชีทั้งหมดที่คุณมีสิทธิ์เข้าถึง ดูข้อมูลเพิ่มเติมได้ที่กรองบัญชีที่คุณเข้าถึงได้

สัปดาห์ของวันที่ 20 เมษายน 2026

• เพิ่ม youtube-affiliate ลงในรายการชื่อโปรแกรมที่ใช้ได้ในคำอธิบายทรัพยากร accounts.programs แล้ว
• เปิดใช้ API ของโปรแกรมสำหรับแอฟฟิลิเอต YouTube Shopping พร้อมให้บริการแก่ผู้ทดสอบที่เชื่อถือได้

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

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

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

• เปิดตัวเมธอด CreateTestAccount ใน Accounts API ซึ่งช่วยให้นักพัฒนาแอปสามารถสร้างบัญชีทดสอบเฉพาะที่ทำงานในสภาพแวดล้อมแบบแซนด์บ็อกซ์ที่แยกต่างหากแบบเป็นโปรแกรมได้ ซึ่งจะช่วยให้มีพื้นที่ที่ปลอดภัยในการพัฒนาและทดสอบการผสานรวม

สัปดาห์ของวันที่ 17 พ.ย. 2025

• ตอนนี้ CreateAndConfigureAccountRequest มีบริการใหม่ที่สามารถกำหนดค่าได้ในระหว่างการตั้งค่าบัญชี ต้องระบุ AccountAggregation, AccountManagement หรือ ComparisonShopping อย่างใดอย่างหนึ่งเท่านั้น นอกจากนี้ คุณยังระบุจำนวนบริการ ProductsManagement และ CampaignsManagement ได้ตามต้องการ อย่างไรก็ตาม ต้องไม่มีบริการ 2 รายการที่มีผู้ให้บริการและรหัสบัญชีภายนอกเหมือนกัน

• ตอนนี้เมธอด AccountsService.CreateAndConfigure มีการตั้งค่าเพื่อควบคุมว่าจะส่งอีเมลยืนยันหรือไม่

• ตอนนี้ CreateAndConfigureAccountRequest.AddAccountService มีช่อง external_account_id (ช่องนี้มีอยู่แล้วในทรัพยากร AccountService) โดยสามารถระบุร่วมกับบริการ CampaignsManagement และ ProductsManagement ได้

• เพิ่มบริการ ComparisonShopping ไปยังทรัพยากร AccountService แล้ว ดูรายละเอียดเพิ่มเติมได้ที่ https://support.google.com/merchants/answer/12653197

• ตอนนี้คุณสามารถตั้งชื่อแทนสำหรับความสัมพันธ์ระหว่างการสร้างบัญชีโดยใช้ช่อง setAlias ใน CreateAndConfigureAccountRequest ได้แล้ว

• เพิ่มเมธอด VerifySelf ลงใน UserService ซึ่งช่วยให้อัปเดตสถานะจาก PENDING เป็น VERIFIED สำหรับทรัพยากร User ที่แสดงถึงผู้ใช้ที่โทรได้

• เปิดตัวช่อง radius_area ใหม่ในเพย์โหลด Region ของ Regions API ซึ่งจะช่วยให้ผู้ขายสร้างภูมิภาคโดยใช้พื้นที่รัศมีได้

สัปดาห์ของวันที่ 10 พ.ย. 2025

• เผยแพร่เวอร์ชัน v1alpha สำหรับ Services API
• เปิดตัวช่อง product_filters ใหม่ในเพย์โหลด CampaignManagement ของ Services API ซึ่งจะช่วยให้ผู้ขายแชร์เฉพาะชุดย่อยของฟีดกับบัญชี Google Ads ได้ โดยอิงตามการกรองแบบมีเงื่อนไขบางอย่างในแอตทริบิวต์ของผลิตภัณฑ์ของผู้ขาย ฟีเจอร์นี้เป็นฟีเจอร์ในรายการที่อนุญาตซึ่งเข้าถึงได้โดยผู้ขายจำนวนจำกัดเท่านั้น

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

• เพิ่มเมธอดกลุ่มใหม่ลงใน Regions API ดังนี้
  • BatchCreateRegions: อนุญาตให้สร้างหลายภูมิภาคในคำขอเดียว
  • BatchUpdateRegions: ช่วยให้สามารถอัปเดตหลายภูมิภาคได้ในคำขอเดียว
  • BatchDeleteRegions: ให้ความสามารถในการลบหลายภูมิภาคตามชื่อในคำขอเดียว

สัปดาห์ของวันที่ 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 ซึ่งจะส่งผลต่อวิธีการอัปเดตเท่านั้น เราขอชี้แจงว่าคุณไม่สามารถอัปเดต 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 เป็นตัวเลือกใน 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

การเปิดตัว API ย่อยของบัญชีในเวอร์ชันเบต้า