แนวทางปฏิบัติที่ดี

เอกสารนี้ให้หลักเกณฑ์เกี่ยวกับแนวทางปฏิบัติแนะนำ ดูข้อมูลเพิ่มเติมได้ที่เคล็ดลับด้านประสิทธิภาพ

กรณีที่ควรใช้ API

วิธีส่งคำขอแบบเป็นโปรแกรม

ไม่ว่าคุณจะต้องการทำให้เวิร์กโฟลว์ทุกส่วนเป็นแบบอัตโนมัติ หรือสร้างฮุกเพื่อเชื่อมต่อกับระบบ ERP (Enterprise Resource Planning) ก็ตาม Content API จะช่วยให้คุณส่งข้อมูลอัปเดตได้ทันทีที่มีการเปลี่ยนแปลงสินค้าคงคลัง

วิธีรับความคิดเห็นทันที

ใน Content API คุณจะได้รับการตอบกลับคำขอทุกรายการทันที แทนที่จะได้รับการตอบกลับผ่านสรุปทางอีเมลหลังจากประมวลผลฟีดข้อมูลแล้ว คำขอกลุ่มขนาดใหญ่จะใช้เวลาในการตอบสนอง 5-10 วินาที

วิธีเปลี่ยนข้อมูลผลิตภัณฑ์บ่อยครั้ง

เมื่อใช้ Content API คุณจะอัปเดตสินค้าคงคลังของผลิตภัณฑ์ที่มีการเปลี่ยนแปลงอย่างรวดเร็วได้หลายครั้งใน 1 วัน แต่การส่งฟีดข้อมูลทั้งหมดทุกครั้งนั้นไม่สามารถทำได้ หากการอัปเดตพร้อมใช้งานทีละรายการ ให้ส่งทีละรายการ อย่ารอจนกว่าจะมีหลายรายการแล้วค่อยส่งพร้อมกัน ในทํานองเดียวกัน หากการอัปเดตมีให้บริการเป็นกลุ่ม ให้ส่งเป็นกลุ่ม อย่าแยกเป็นคําขอแต่ละรายการ

วิธีจัดการบัญชีย่อยหลายบัญชี

บัญชี Merchant Center ที่สร้างขึ้นใหม่จะเป็นบัญชีเดียวที่มีชุดข้อมูลผลิตภัณฑ์ของตัวเอง วิธีนี้ใช้ได้ผลดีในเกือบทุกกรณี แต่เมื่อบัญชีเติบโตขึ้น คุณอาจพบว่าต้องใช้ระบบการจัดการที่ซับซ้อนมากขึ้นสำหรับผลิตภัณฑ์ ในกรณีนี้ ให้พิจารณาใช้บัญชีหลายลูกค้าหรือ MCA การจัดการบัญชี MCA ที่ระดับ API ทำได้ผ่านบริการบัญชี และอนุญาตให้เพิ่มและจัดการบัญชีย่อยแบบเป็นโปรแกรม ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างบัญชี MCA ได้ที่นี่

วิธีใช้ API

อย่าใช้ API เหมือนกับที่ใช้ฟีดข้อมูล

หลีกเลี่ยงการอัปเดตฟีดผลิตภัณฑ์ทั้งหมดทุกวันเมื่อใช้แหล่งข้อมูล products แต่ให้อัปเดตเฉพาะผลิตภัณฑ์ที่มีการเปลี่ยนแปลงข้อมูลจริงๆ เท่านั้น การส่งฟีดข้อมูลทั้งหมดผ่านแหล่งข้อมูล products จะใช้เวลาและทรัพยากรทั้งของคุณและ Google มากขึ้น

อย่าใช้ API เพื่อดึงข้อมูลผลิตภัณฑ์ที่คุณอัปโหลดเป็นประจำ

หากคุณมีหน้าที่รับผิดชอบในการดูแลรักษาข้อมูลผลิตภัณฑ์ในบัญชี Merchant Center หนึ่งๆ โปรดหลีกเลี่ยงการขอข้อมูลผลิตภัณฑ์จาก Content API ผ่านวิธีการ products.get หรือ products.list เป็นประจำ สําหรับลูกค้าที่จะอัปโหลดข้อมูล วิธีเหล่านี้จะช่วยแก้ไขข้อบกพร่องเมื่อออกแบบโซลูชันที่ใช้ Content API แต่ไม่ได้มีไว้สำหรับการดึงข้อมูลผลิตภัณฑ์เป็นประจำโดยลูกค้าดังกล่าว คุณควรมีแหล่งข้อมูลอื่นสำหรับข้อมูลผลิตภัณฑ์ เช่น ฐานข้อมูลผลิตภัณฑ์ในร้าน และผลิตภัณฑ์ใน Merchant Center ควรแสดงเนื้อหาของแหล่งข้อมูลนั้น

อย่าใช้ทั้งฟีดข้อมูลและ Content API เพื่อส่งสินค้า

หากกำลังพิจารณาเปลี่ยนไปใช้ API สำหรับการส่งสินค้า โปรดตรวจสอบว่าคุณไม่ได้ใช้ฟีดข้อมูลเพื่อส่งสินค้าอีกต่อไป หากคุณส่งรายการในทั้ง 2 สื่อต่อไปเรื่อยๆ อาจเกิดผลลัพธ์ที่ไม่คาดคิด

ฉันจะใช้ API และฟีดข้อมูลร่วมกันอย่างปลอดภัยได้ไหม

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

ตัวอย่างอื่นๆ ของวิธีใช้ฟีดและ API ร่วมกันที่ยอมรับได้ ได้แก่

• การดำเนินการตามคำขอแบบอ่านอย่างเดียว (get หรือ list) จาก API: ผู้ขายบางรายต้องการใช้ API เพื่อดึงข้อมูลและการอัปเดตสถานะเกี่ยวกับผลิตภัณฑ์ ซึ่งยอมรับได้เนื่องจากข้อมูลผลิตภัณฑ์จะอัปเดตจากฟีดเท่านั้น

• การใช้ API เพื่อจัดการบัญชีย่อย (Accounts Service) และ/หรือการตั้งค่าภาษีและการจัดส่งระดับบัญชี (Accounttax Service และ Shippingsettings Service) ฟังก์ชันเหล่านี้ไม่ใช่ฟังก์ชันที่ฟีดข้อมูลให้ ดังนั้นจึงไม่ขัดแย้งกับการใช้ API เพื่อจัดการฟังก์ชันเหล่านี้

ฉันจะย้ายข้อมูลจากการใช้ฟีดข้อมูลไปใช้ API เท่านั้นหรือในทางกลับกันได้อย่างไร

หากตอนนี้คุณใช้ฟีดข้อมูลและต้องการเปลี่ยนไปใช้ API ในการอัปเดตผลิตภัณฑ์เท่านั้น คุณจะต้องอัปโหลดข้อมูลผลิตภัณฑ์อีกครั้งด้วย API เมื่อคุณใช้products service เพื่ออัปเดตผลิตภัณฑ์หนึ่งๆ API จะควบคุมข้อมูลผลิตภัณฑ์นั้น และการลบผลิตภัณฑ์ออกจากฟีดข้อมูลหรือลบฟีดข้อมูลเองจะไม่นำข้อมูลผลิตภัณฑ์ออกจากบัญชี Merchant Center อีกต่อไป ตรวจสอบว่าไม่มีการอัปเดตฟีดข้อมูลหากต้องการนำผลิตภัณฑ์ออกจากฟีดข้อมูลหรือนำฟีดข้อมูลออก ไม่เช่นนั้นฟีดข้อมูลจะเป็นเจ้าของอีกครั้งและการนำผลิตภัณฑ์ออกจากฟีดข้อมูลจะทำให้ผลิตภัณฑ์ถูกนำออก

หากปัจจุบันคุณใช้เฉพาะ API สำหรับข้อมูลผลิตภัณฑ์และต้องการใช้ฟีดข้อมูลเป็นแหล่งข้อมูลผลิตภัณฑ์หลัก ก็เพียงเพิ่มฟีดข้อมูลใหม่ลงในบัญชี Merchant Center แล้วฟีดดังกล่าวจะเป็นผู้รับสิทธิ์ความเป็นเจ้าของผลิตภัณฑ์ที่แสดง หากมีผลิตภัณฑ์ที่คุณต้องการนำออกก่อนที่ผลิตภัณฑ์จะหมดอายุซึ่งอัปโหลดจาก API เพียงอย่างเดียว คุณต้องลบผลิตภัณฑ์เหล่านั้นผ่าน Merchant Center หรือผ่าน API

ฉันจะกำหนดเป้าหมายไปยังหลายประเทศด้วยผลิตภัณฑ์โดยใช้ Content API for Shopping ได้อย่างไร

หากต้องการกำหนดเป้าหมายไปยังหลายประเทศด้วยโฆษณาและข้อมูลที่แสดงฟรีสำหรับผลิตภัณฑ์ที่ส่งผ่าน Content API ให้กำหนดค่าประเทศเพิ่มเติมในฟีดหลักของ Content API ใน Merchant Center หรือเพิ่มประเทศเพิ่มเติมเหล่านั้นผ่านช่อง shipping ในแหล่งข้อมูล products

ตัวอย่างวิธีแก้ไขการตั้งค่าฟีดหลักของ Content API มีดังนี้

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อการกำหนดเป้าหมายโฆษณา Shopping และข้อมูลที่แสดงฟรีในหลายประเทศ

ตรวจสอบว่าไลบรารีไคลเอ็นต์เป็นเวอร์ชันล่าสุด

หากคุณใช้ไลบรารีไคลเอ็นต์ของ Google เพื่อโต้ตอบกับ Content API ให้ตรวจสอบว่าคุณใช้เครื่องมือจัดการแพ็กเกจสำหรับภาษาโปรแกรมที่เลือก และตรวจสอบว่าเวอร์ชันไลบรารีเป็นเวอร์ชันล่าสุด ดูข้อมูลเพิ่มเติมได้ที่คู่มือสำหรับนักพัฒนาซอฟต์แวร์ของภาษาที่เลือกในตัวอย่างและไลบรารี

อย่าลืมใช้แอตทริบิวต์ปลายทางเพื่อควบคุมว่าผลิตภัณฑ์ใดจะปรากฏในโปรแกรม Shopping ต่างๆ

Content API จะใช้การตั้งค่าเริ่มต้นสำหรับฟีด Content API โดยอัตโนมัติตามที่กำหนดค่าไว้ใน Merchant Center คุณสามารถใช้แอตทริบิวต์ผลิตภัณฑ์ includedDestinations หรือ excludedDestinations เพื่อควบคุมการเข้าร่วมโปรแกรมในระดับผลิตภัณฑ์ภายในฟีดหรือผ่าน Content API

หากฟีด API เลือกเข้าร่วมโปรแกรม เช่น ซื้อใน Google (เดิมเรียกว่า Shopping Actions) แต่คุณต้องการยกเว้นผลิตภัณฑ์บางรายการ ให้ใช้แอตทริบิวต์ excludedDestinations และระบุ Shopping Actions เป็นค่า หากไม่มีข้อผิดพลาด ระบบจะเขียนทับการตั้งค่าฟีดเริ่มต้นใน Merchant Center และสินค้านั้นจะไม่แสดงใน "ซื้อใน Google" (เดิมเรียกว่า Shopping Actions) ในทางกลับกัน หากฟีดไม่ได้เลือกใช้โปรแกรม เช่น Shopping คุณจะรวมสินค้าแต่ละรายการได้โดยใช้แอตทริบิวต์ includedDestinations และ Shopping_ads เป็นค่า แล้วสินค้าจะแสดงในโฆษณา Shopping

ดูข้อมูลเพิ่มเติมเกี่ยวกับแอตทริบิวต์ผลิตภัณฑ์ includedDestinations และ excludedDestinations ได้ที่ศูนย์ช่วยเหลือ

โปรดอัปเดตรายการก่อนหมดอายุ

หากรายการไม่มีการเปลี่ยนแปลงก่อนหมดอายุ ให้อัปเดตรายการภายใน 30 วันหลังจากการอัปเดตครั้งล่าสุด หรือภายในวันที่หมดอายุที่ระบุไว้หากเร็วกว่านั้น เพื่อไม่ให้ระบบปิดใช้งานรายการ หากต้องการอัปเดตรายการหลายรายการเนื่องจากไม่มีรายการใดเปลี่ยนแปลงหรือคุณไม่สามารถติดตามเวลาที่อัปเดตล่าสุดได้ อย่าอัปเดตรายการทั้งหมดพร้อมกัน แต่ให้กระจายการอัปเดตอย่างสม่ำเสมอเป็นเวลาหลายวัน

อย่าลบฟีด Content API ไม่เช่นนั้นผลิตภัณฑ์อาจหายไป

เมื่อคุณอัปโหลดผลิตภัณฑ์ที่มี channel:online ผ่าน Content API เป็นครั้งแรก ฟีดใหม่จะปรากฏใน Merchant Center โดยใช้ชื่อว่า Content API เมื่อคุณอัปโหลดผลิตภัณฑ์ที่มี channel:local ผ่าน Content API เป็นครั้งแรก ฟีดใหม่จะปรากฏใน Merchant Center ชื่อว่า Content API พร้อมหัวเรื่องย่อยว่า ผลิตภัณฑ์ในร้าน ตรวจสอบว่าคุณไม่ได้ลบฟีด Content API ออนไลน์หรือฟีด Content API ในเครื่องโดยไม่ตั้งใจ ระบบจะนำผลิตภัณฑ์ออนไลน์หรือผลิตภัณฑ์ในร้านที่คุณเพิ่มลงใน Merchant Center ผ่าน Content API ออก ทั้งนี้ขึ้นอยู่กับฟีดที่คุณลบ

ส่งคำขอหลายรายการไปยังบริการเดียวกันพร้อมกันโดยใช้เมธอด custombatch

แทนที่จะส่งคําขอหลายรายการตามลําดับหรือพร้อมกันไปยังบริการเดียวกัน ให้ส่งคําขอแบบเป็นกลุ่มที่กําหนดเองรายการเดียวซึ่งมีคําขอทั้งหมดที่ต้องการ วิธีนี้จะทำให้เวลาในการตอบสนองของการส่งคำขอไปยังปลายทาง API เกิดขึ้นเพียงครั้งเดียวสำหรับการเรียกใช้ custombatch แทนที่จะเป็นคำขอแต่ละรายการ ซึ่งสำคัญอย่างยิ่งหากคุณส่งคำขอตามลำดับ

อย่าส่งการอัปเดตหลายรายการไปยังรายการเดียวในครั้งเดียว

ซึ่งจะให้ผลลัพธ์ที่ไม่คาดคิดเนื่องจากความไม่แน่นอนเกี่ยวกับลำดับการอัปเดต และอาจทำให้เกิดข้อผิดพลาดในการทับซ้อนกัน

ไม่ต้องส่งข้อมูลอัปเดตสำหรับรายการที่ไม่มีการเปลี่ยนแปลง

ตรวจสอบว่าคุณส่งคำขอสำหรับรายการผลิตภัณฑ์ใหม่ เปลี่ยนแปลง หรือลบแล้วเท่านั้น เว้นแต่ว่ารายการดังกล่าวจะหมดอายุ

ใช้ฟีดเสริมหากราคาและ/หรือความพร้อมจำหน่ายเปลี่ยนแปลงอย่างรวดเร็ว

หากพบปัญหาในการอัปเดตข้อมูลราคา ความพร้อมจำหน่าย หรือการขายของผลิตภัณฑ์อยู่เสมอ ให้ลองใช้ฟีดเสริมในแหล่งข้อมูล products เพื่อส่งการอัปเดตสำหรับแอตทริบิวต์เหล่านั้นเท่านั้น เนื่องจากการอัปเดตฟีดเสริมมีข้อมูลไม่มาก คุณจึงอัปเดตฟีดเสริมได้หลายครั้งกว่าการอัปเดตผลิตภัณฑ์ทั้งหมดในระยะเวลาหนึ่งๆ ซึ่งจะช่วยให้ราคาและความพร้อมจำหน่ายสินค้าของผลิตภัณฑ์สอดคล้องกับหน้า Landing Page อยู่เสมอ

อีกวิธีในการอัปเดตราคาและความพร้อมจำหน่ายสินค้าของผลิตภัณฑ์คือการใช้การอัปเดตสินค้าอัตโนมัติ ซึ่งสามารถใช้ควบคู่กับการอัปเดต API เพื่อช่วยหลีกเลี่ยงข้อมูลใน Merchant Center กับข้อมูลในหน้า Landing Page ของผลิตภัณฑ์ไม่ตรงกัน อย่างไรก็ตาม โปรดทราบว่าฟีเจอร์นี้ออกแบบมาเพื่อแก้ไขปัญหาเล็กๆ น้อยๆ เกี่ยวกับความถูกต้องของราคาและความพร้อมจำหน่ายสินค้าของผลิตภัณฑ์ ดังนั้นการอัปเดตสินค้าอัตโนมัติจึงไม่ได้แทนที่การให้ข้อมูลที่ถูกต้องผ่าน API

กรณีที่ควรใช้โทเค็นรีเฟรช

ระบบจะแสดงโทเค็นรีเฟรชในส่วนหัว HTTP ของคำขอการให้สิทธิ์ ข้อมูลนี้ประกอบด้วยข้อมูลอื่นๆ ที่เกี่ยวข้องกับการตรวจสอบสิทธิ์มากมาย แต่โทเค็นรีเฟรชมักเป็นสิ่งที่นักพัฒนาแอปต้องการ เนื่องจากช่วยให้ไม่ต้องแจ้งให้ผู้ใช้ตรวจสอบสิทธิ์ซ้ำๆ เนื่องจากโทเค็นการเข้าถึงมีอายุเพียง 60 นาทีก่อนที่จะหมดอายุ