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

สัปดาห์ที่ 28 กันยายน 2026

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

สัปดาห์ที่ 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 จัดการประสบการณ์การเข้าถึงลูกค้าจากทุกช่องทาง (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 เป็นตัวเลือกตลอดทั้ง 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 เวอร์ชันเบต้า