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

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

กรณีที่ควรใช้ 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 ที่ยอมรับได้ร่วมกันมีดังนี้

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

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

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

หากตอนนี้คุณใช้ฟีดข้อมูลและต้องการเปลี่ยนไปใช้เฉพาะ API ในการอัปเดตผลิตภัณฑ์ คุณจะต้องอัปโหลดข้อมูลผลิตภัณฑ์อีกครั้งด้วย API เมื่อคุณใช้บริการผลิตภัณฑ์เพื่ออัปเดตผลิตภัณฑ์หนึ่งๆ 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 ออนไลน์หรือฟีดในเครื่องโดยไม่ได้ตั้งใจ ผลิตภัณฑ์ออนไลน์หรือผลิตภัณฑ์ในร้านที่คุณเพิ่มลงใน Merchant Center ผ่าน Content API จะถูกนำออกไป ทั้งนี้ขึ้นอยู่กับฟีดที่คุณลบ

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

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

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

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

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

โปรดส่งเฉพาะคำขอสินค้าใหม่ ที่มีการเปลี่ยนแปลง หรือลบแล้ว เว้นแต่สินค้าจะหมดอายุ

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

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

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

เมื่อใดที่ควรใช้โทเค็นการรีเฟรช

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