แนวทางปฏิบัติแนะนำ

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

ควรใช้ API เมื่อใด

หากต้องการส่งคำขอแบบเป็นโปรแกรม

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

หากต้องการรับความคิดเห็นทันที

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

หากต้องการเปลี่ยนข้อมูลผลิตภัณฑ์บ่อยๆ

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

หากต้องการจัดการบัญชีย่อยหลายบัญชี

บัญชี 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 และฟีดข้อมูลร่วมกันได้อย่างปลอดภัยหรือไม่

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

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

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

• การใช้ API เพื่อจัดการบัญชีย่อย (บัญชี บริการ) และ/หรือ การตั้งค่าภาษีและการจัดส่งระดับบัญชี (ภาษีบัญชี บริการ และ การตั้งค่าการจัดส่ง บริการ) ฟังก์ชันเหล่านี้ไม่ใช่ฟังก์ชันที่ 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 โปรดใช้ตัวจัดการแพ็กเกจสำหรับภาษาโปรแกรมที่คุณเลือกและตรวจสอบว่าไลบรารีเป็นเวอร์ชันล่าสุด ดูข้อมูลเพิ่มเติมได้ใน คู่มือสำหรับนักพัฒนาแอปสำหรับภาษาที่คุณเลือกใน ตัวอย่างและไลบรารี

ตรวจสอบว่าได้ใช้แอตทริบิวต์ปลายทางเพื่อควบคุมผลิตภัณฑ์ที่จะปรากฏในโปรแกรม 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

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

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

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

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

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

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

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

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

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

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