เอกสารนี้มีหลักเกณฑ์เกี่ยวกับแนวทางปฏิบัติแนะนำ ดูเคล็ดลับด้านประสิทธิภาพสำหรับข้อมูลเพิ่มเติม
กรณีที่ควรใช้ API
เพื่อส่งคำขอแบบเป็นโปรแกรม
ไม่ว่าคุณจะต้องการให้กระบวนการทำงานทุกส่วนเป็นระบบอัตโนมัติ หรือสร้างฮุกในระบบ ERP (Enterprise Resource Strategy) ของคุณ Content API ก็ช่วยให้คุณส่งการอัปเดตได้ทันทีที่สินค้าคงคลังมีการเปลี่ยนแปลง
เพื่อรับความคิดเห็นทันที
ใน Content API คุณจะได้รับการตอบกลับสำหรับทุกคำขอทันทีแทนที่จะตอบกลับอีเมลสรุปหลังจากประมวลผลฟีดข้อมูล คาดว่าคำขอจำนวนมากจะมีเวลาในการตอบสนอง 5-10 วินาที
เพื่อเปลี่ยนข้อมูลผลิตภัณฑ์บ่อยๆ
คุณสามารถใช้ Content API ทำการอัปเดตเพิ่มเติมกับสินค้าคงคลังของผลิตภัณฑ์ที่มีการเปลี่ยนแปลงอย่างรวดเร็วได้หลายครั้งใน 1 วัน แต่การส่งฟีดข้อมูลทั้งฟีดทุกครั้งนั้นทำไม่ได้ หากมีการอัปเดตทีละรายการ ให้ส่งการอัปเดตทีละรายการ อย่ารอจนกว่าจะมีการอัปเดตหลายรายการเพื่อให้ดำเนินการแบบเป็นกลุ่มได้ ในทำนองเดียวกัน หากมีการอัปเดตหลายรายการ ให้ส่งเป็นแบทช์ และอย่าแยกคำขอออกเป็นคำขอแต่ละรายการ
เพื่อจัดการบัญชีย่อยหลายบัญชี
บัญชี Merchant Center ที่สร้างขึ้นใหม่จะเป็นบัญชีเดียว และเก็บชุดข้อมูลผลิตภัณฑ์ไว้เอง วิธีนี้ได้ผลดีในกรณีส่วนใหญ่ แต่เมื่อบัญชีเติบโตขึ้น คุณอาจพบว่าจำเป็นต้องใช้ระบบการจัดการที่ซับซ้อนยิ่งขึ้นสำหรับผลิตภัณฑ์ ในกรณีนี้ ให้พิจารณาใช้บัญชีหลายลูกค้าหรือ MCA การจัดการระดับ API ของบัญชี MCA ดำเนินการผ่านบริการบัญชีได้ ทั้งยังอนุญาตให้เพิ่มและจัดการบัญชีย่อยแบบเป็นโปรแกรมได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีรับบัญชี 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 เพื่อจัดการบัญชีย่อย (บัญชี บริการ) และ/หรือการตั้งค่าภาษีและการจัดส่งระดับบัญชี (Accounttax Service และShippingsettings Service) ฟังก์ชันเหล่านี้ไม่ใช่ฟังก์ชันที่ Datafeeds ให้ได้ จึงไม่ขัดแย้งกับการใช้ 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 อย่าลืมใช้โปรแกรมจัดการแพ็กเกจสำหรับภาษาโปรแกรมที่คุณเลือกและตรวจสอบว่าเวอร์ชันไลบรารีอัปเดตแล้ว ดูข้อมูลเพิ่มเติมได้ในคู่มือสำหรับนักพัฒนาซอฟต์แวร์ตามภาษาที่คุณเลือกในตัวอย่างและคลัง
อย่าลืมใช้แอตทริบิวต์ปลายทางเพื่อควบคุมว่าจะแสดงผลิตภัณฑ์ใดในโปรแกรมช็อปปิ้งต่างๆ
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 พร้อมส่วนหัวย่อยของ Local Products โปรดตรวจสอบว่าคุณไม่ได้ลบฟีด Content API ออนไลน์หรือฟีด Content API ในเครื่องโดยไม่ตั้งใจ ระบบจะนำผลิตภัณฑ์ออนไลน์หรือผลิตภัณฑ์ในร้านที่คุณเพิ่มลงใน Merchant Center ผ่าน Content API ออก ทั้งนี้ขึ้นอยู่กับฟีดที่คุณลบ
จัดกลุ่มคำขอหลายรายการไปยังบริการเดียวกันโดยใช้เมธอด custombatch
แทนที่จะส่งคำขอจำนวนมากตามลำดับหรือคำขอพร้อมกันไปยังบริการเดียวกัน ให้ส่งคำขอกลุ่มที่กำหนดเองรายการเดียวที่มีคำขอที่ต้องการทั้งหมด วิธีนี้ทำให้เวลาในการตอบสนองของการส่งคำขอไปยังปลายทาง API เกิดขึ้นเพียงครั้งเดียวสำหรับการเรียกใช้กลุ่มที่กำหนดเอง แทนที่จะดำเนินการกับคำขอแต่ละรายการ ซึ่งสำคัญมากในกรณีที่คุณส่งคำขอตามลำดับ
อย่าส่งการอัปเดตหลายรายการไปยังสินค้ารายการเดียวในกลุ่มเดียว
ซึ่งจะให้ผลลัพธ์ที่ไม่คาดคิดเนื่องจากความไม่แน่นอนของลําดับการอัปเดตและอาจทำให้เกิดข้อผิดพลาดเกี่ยวกับข้อขัดแย้ง
อย่าส่งการอัปเดตสำหรับรายการที่ไม่เปลี่ยนแปลง
ตรวจสอบว่าคุณส่งคำขอสำหรับผลิตภัณฑ์ใหม่ ผลิตภัณฑ์ที่เปลี่ยนแปลง หรือลบแล้วเท่านั้น เว้นแต่ว่าสินค้าจะหมดอายุ
ใช้ฟีดเสริมหากราคาและ/หรือความพร้อมจำหน่ายสินค้ามีการเปลี่ยนแปลงอย่างรวดเร็ว
หากพบปัญหาในการอัปเดตราคา ความพร้อมจำหน่าย หรือการขายของผลิตภัณฑ์ ให้ลองใช้ฟีดเสริมในทรัพยากร products เพื่อส่งการอัปเดตสำหรับแอตทริบิวต์เหล่านั้นเท่านั้น เนื่องจากการอัปเดตฟีดเสริมมีขนาดเล็ก คุณจึงอัปเดตฟีดเสริมได้มากกว่าการอัปเดตผลิตภัณฑ์แบบเต็มในระยะเวลาหนึ่งๆ ซึ่งจะช่วยให้ราคาและความพร้อมจำหน่ายของผลิตภัณฑ์สอดคล้องกับหน้า Landing Page
อีกวิธีในการอัปเดตราคาและความพร้อมจำหน่ายผลิตภัณฑ์คือการใช้การอัปเดตสินค้าอัตโนมัติ คุณจะใช้การตั้งค่านี้นอกเหนือจากการอัปเดต API เพื่อหลีกเลี่ยงความไม่ตรงกันระหว่างข้อมูลใน Merchant Center กับข้อมูลในหน้า Landing Page ของผลิตภัณฑ์ได้ อย่างไรก็ตาม โปรดทราบว่าวิธีนี้ออกแบบมาเพื่อแก้ไขปัญหาเล็กๆ น้อยๆ เกี่ยวกับความถูกต้องของราคาและความพร้อมจำหน่ายของผลิตภัณฑ์ ดังนั้นการอัปเดตสินค้าอัตโนมัติจึงไม่ได้ทดแทนการให้ข้อมูลที่ถูกต้องผ่าน API
ควรใช้โทเค็นการรีเฟรชเมื่อใด
ระบบจะส่งโทเค็นการรีเฟรชในส่วนหัว HTTP ของคำขอการให้สิทธิ์ ในนี้ยังมีข้อมูลอื่นๆ เกี่ยวกับการตรวจสอบสิทธิ์อีกมากมาย แต่โทเค็นสำหรับรีเฟรชมักเป็นส่วนที่นักพัฒนาซอฟต์แวร์ต้องการใช้งานเนื่องจากไม่จำเป็นต้องแจ้งเตือนให้ผู้ใช้ตรวจสอบสิทธิ์ซ้ำๆ เนื่องจากโทเค็นเพื่อการเข้าถึงจะใช้ได้เพียง 60 นาทีก่อนที่จะหมดอายุ