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

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

• เผยแพร่ 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 จัดการประสบการณ์การเข้าถึงลูกค้าจากทุกช่องทาง (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 จากระดับ 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 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

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