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

สัปดาห์ที่ 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

  • เผยแพร่ Services API เวอร์ชัน v1alpha
  • เปิดตัวช่อง 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

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

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

  • เปิดตัวทรัพยากรนโยบายการคืนสินค้าออนไลน์ ซึ่งช่วยให้ผู้ใช้ API สร้าง อัปเดต และลบนโยบายการคืนสินค้าได้
  • เปิดตัว OmnichannelSettingsService และทรัพยากร OmnichannelSetting ซึ่งช่วยให้ผู้ใช้ API จัดการประสบการณ์การเข้าถึงลูกค้าจากทุกช่องทางได้
  • เปิดตัว 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

-The 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 จะย้ายจากระดับ relationship ไปอยู่ที่ระดับ service ดังนั้น ตอนนี้ตัวกรอง 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

ปรับปรุงเอกสารประกอบของทรัพยากรต่างๆ ของ Accounts Sub-API เช่น User, Homepage, BusinessInfo และอื่นๆ

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

ปรับปรุงเอกสารประกอบของช่อง update_mask ในคำขออัปเดตทั้งหมดเพื่อระบุช่องที่รองรับการอัปเดตโดยเฉพาะ

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

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

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

ทำให้ update_mask เป็นตัวเลือกใน Accounts 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 เวอร์ชันเบต้า