จัดการแคตตาล็อกผลิตภัณฑ์

คู่มือนี้อธิบายวิธีใช้ Google Play Developer API เพื่อสร้างและจัดการแคตตาล็อกสินค้าสำหรับแอป Play

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

Catalog Management API

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

  • ผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว
  • ผลิตภัณฑ์ที่ต้องสมัครใช้บริการ

ผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว

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

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

ผลิตภัณฑ์ที่ต้องสมัครใช้บริการ

ปลายทาง monetization.subscriptions ช่วยให้คุณจัดการผลิตภัณฑ์ที่ต้องสมัครใช้บริการจากแบ็กเอนด์ของนักพัฒนาแอปได้ คุณสามารถทำสิ่งต่างๆ เช่น สร้าง อัปเดต และลบการสมัครใช้บริการ หรือควบคุมความพร้อมจำหน่ายสินค้าและการกำหนดราคาระดับภูมิภาค นอกจากปลายทาง monetization.subscriptions แล้ว เรายังมี monetization.subscriptions.basePlans และ monetization.subscriptions.basePlans.offers เพื่อจัดการแพ็กเกจเริ่มต้นและข้อเสนอของการสมัครใช้บริการตามลำดับด้วย

วิธีการแบบกลุ่ม

ปลายทาง onetimeproducts, inappproducts และ monetization.subscriptions มีเมธอดแบบกลุ่มจำนวนหนึ่งที่ช่วยให้คุณสามารถดึงข้อมูลหรือจัดการเอนทิตีได้สูงสุด 100 รายการภายใต้แอปเดียวกันในเวลาเดียวกัน

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

เวลาในการตอบสนองของการเผยแพร่การอัปเดตเทียบกับอัตราการส่งผ่านข้อมูล

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

การกำหนดค่าโควต้า

คุณควรทราบถึงขีดจำกัดโควต้าหลายรายการเมื่อใช้ Play Developer API เพื่อจัดการแคตตาล็อกสินค้า ดังนี้

  1. Google Play Developer API จะจัดระเบียบเป็นหมวดหมู่ที่เรียกว่าที่เก็บข้อมูล โดยที่เก็บข้อมูลแต่ละรายการจะมีขีดจำกัดโควต้าต่อนาทีของตัวเอง ดูข้อมูลเพิ่มเติมได้ที่โควต้า
  2. นอกจากนี้ ปลายทางการแก้ไขผลิตภัณฑ์ยังจำกัดคำค้นหาไว้ที่ 7,200 รายการต่อชั่วโมงด้วย ขีดจำกัดนี้เป็นขีดจำกัดเดียวสำหรับทั้งผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวและการสมัครใช้บริการ รวมถึงคำขอแก้ไขทั้งหมด ซึ่งรวมถึงการสร้าง การอัปเดต การเปิดใช้งาน และการลบ การเรียกใช้เมธอดการแก้ไขแบบกลุ่มจะนับเป็นการค้นหา 1 รายการสำหรับโควต้านี้ ไม่ว่าจะมีคำขอแต่ละรายการรวมอยู่ด้วยกี่รายการหรือมีความไวต่อเวลาแฝงเพียงใดก็ตาม
  3. การแก้ไขที่ไวต่อเวลาในการตอบสนองยังมีขีดจำกัดอยู่ที่ 7,200 รายการต่อชั่วโมงด้วย สำหรับเมธอดแบบกลุ่ม คำขอแก้ไขที่ฝังอยู่แต่ละรายการจะนับแยกกันเพื่อวัตถุประสงค์ของโควต้านี้ โควต้านี้มีผลในทางปฏิบัติเฉพาะกับผู้ใช้ Batch API ที่ทำการอัปเดตที่ไวต่อเวลาในการตอบสนองเท่านั้น เนื่องจากในกรณีอื่นๆ โควต้า 2 จะหมดก่อนหรือพร้อมกันกับโควต้านี้

ต่อไปนี้เป็นตัวอย่างที่แสดงให้เห็นถึงการใช้โควต้าของคำขอต่างๆ

  • คำขอ get รายการเดียวเพื่อดึงข้อมูล 1 รายการจะใช้โควต้า 1 จำนวน 1 โทเค็น และไม่ใช้โทเค็นของโควต้า 2 และ 3 (เนื่องจากเกี่ยวข้องกับปลายทางการแก้ไขเท่านั้น)
  • คำขอ get แบบกลุ่มเพื่อดึงข้อมูลสินค้าสูงสุด 100 รายการจะใช้โควต้า 1 จำนวน 1 โทเค็น และไม่ใช้โทเค็นของโควต้า 2 และ 3
  • คำขอ modification รายการเดียวสำหรับสินค้า 1 รายการจะใช้โทเค็น 1 รายการของโควต้า 1 และโทเค็น 1 รายการของโควต้า 2 หากคำขอมีความไวต่อเวลาในการตอบสนอง ระบบจะใช้โทเค็น 1 รายการของโควต้า 3 ด้วย เนื่องจากโควต้า C มีขีดจำกัดเดียวกับโควต้า 2 จึงไม่มีผลในทางปฏิบัติสำหรับผู้ใช้ที่ใช้วิธีการแก้ไขเดียวเท่านั้น
  • คำขอ modification แบบกลุ่มสำหรับรายการที่ยอมรับเวลาในการตอบสนองได้ 100 รายการจะใช้โควต้า 1 จำนวน 1 โทเค็น และโควต้า 2 จำนวน 1 โทเค็น การตั้งค่าโควต้านี้ควรมีระยะเผื่อที่เพียงพอเพื่อให้แคตตาล็อกอัปเดตอยู่เสมอ แต่หากอัลกอริทึมของคุณไม่ทราบถึงโควต้านี้และเกินอัตรานี้ คุณอาจได้รับข้อผิดพลาดต่อการเรียกเพิ่มเติม
  • คำขอแบบกลุ่ม modification สำหรับรายการที่ไวต่อเวลาในการตอบสนอง 100 รายการจะใช้โควต้า 1 จำนวน 1 โทเค็น โควต้า 2 จำนวน 1 โทเค็น และโควต้า 3 จำนวน 100 โทเค็น

คำแนะนำในการใช้งาน Catalog Management API

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

ตรวจสอบการใช้งาน

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

เพิ่มประสิทธิภาพการใช้โควต้า API

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

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

เพิ่มตรรกะการจัดการข้อผิดพลาดเกี่ยวกับโควต้า

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

{
  "code" : 403,
  "errors" : [ {
    "domain" : "usageLimits",
    "message" : "Daily Limit Exceeded. The quota will be reset at midnight Pacific Time (PT). You may monitor your quota usage and adjust limits in the API
  Console: https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxxx",
  "reason" : "dailyLimitExceeded",
  "extendedHelp" : "https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxx"
  } ],
}

การติดตั้งใช้งานการจัดการแคตตาล็อก

นักพัฒนาแอปใช้ปลายทางการเผยแพร่ผลิตภัณฑ์ของ Google Play Developer API เพื่อซิงค์แคตตาล็อกระหว่างแบ็กเอนด์กับ Google Play การตรวจสอบว่าแคตตาล็อก Google Play ของคุณอัปเดตข้อมูลล่าสุดของแคตตาล็อกแบ็กเอนด์อยู่เสมอมีข้อดีในการสร้างประสบการณ์ของผู้ใช้ที่ดียิ่งขึ้น เช่น

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

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

กลยุทธ์การซิงค์แคตตาล็อก

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

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

เวลาที่จะส่งการอัปเดตเมื่อแคตตาล็อกในร้านมีการเปลี่ยนแปลง

คุณควรอัปเดตทันทีที่มีการเปลี่ยนแปลงแคตตาล็อกสินค้าของแบ็กเอนด์เพื่อลดความคลาดเคลื่อนให้เหลือน้อยที่สุด

การอัปเดตประเภทนี้เหมาะสำหรับกรณีต่อไปนี้

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

วิธีนี้ใช้งานได้ง่ายกว่า และช่วยให้คุณซิงค์แคตตาล็อกได้โดยมีหน้าต่างความคลาดเคลื่อนน้อยที่สุด

กรณีที่ควรใช้การอัปเดตเป็นระยะ

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

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

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

สร้างแคตตาล็อกสินค้า

หากมีแคตตาล็อกขนาดใหญ่ที่ต้องการอัปโหลดไปยัง Google Play คุณอาจต้องทำให้การโหลดครั้งแรกเป็นแบบอัตโนมัติ กระบวนการที่หนักหน่วงประเภทนี้จะทำงานได้ดีที่สุดหากใช้กลยุทธ์เป็นระยะร่วมกับวิธีการแบบกลุ่มที่ทนต่อเวลาในการตอบสนอง

สร้างผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว

สำหรับการสร้างแคตตาล็อกผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวในครั้งแรก เราขอแนะนำให้ใช้เมธอด monetization.onetimeproducts.batchUpdate หรือ inapp_products.insert โดยตั้งค่าช่อง allowMissing เป็น true และตั้งค่าช่อง latencyTolerance เป็น PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT ซึ่งจะช่วยลดเวลาที่ใช้ในการสร้างแคตตาล็อกภายในขีดจำกัดโควต้า

สร้างผลิตภัณฑ์ที่ต้องสมัครใช้บริการ

สำหรับการสร้างแคตตาล็อกขนาดใหญ่สำหรับการสมัครใช้บริการครั้งแรก เราขอแนะนำให้ใช้เมธอด monetization.subscriptions.batchUpdate โดยตั้งค่าช่อง allowMissing เป็น true และตั้งค่าช่อง latencyTolerance เป็น PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT ซึ่งจะช่วยลดเวลาที่ใช้ในการสร้างแคตตาล็อกภายในขีดจำกัดโควต้า

สำหรับแคตตาล็อกการสมัครใช้บริการขนาดเล็ก Play Developer API มีเมธอด monetization.subscriptions.create หรือจะสร้างการสมัครใช้บริการโดยใช้เมธอด monetization.subscriptions.patch ที่มีพารามิเตอร์ allowMissing ตามที่อธิบายไว้ในส่วนการอัปเดตผลิตภัณฑ์ก็ได้

วิธีการก่อนหน้านี้ทั้งหมดจะสร้างการสมัครใช้บริการพร้อมกับแพ็กเกจเริ่มต้น (ระบุไว้ในออบเจ็กต์การสมัครใช้บริการ) แพ็กเกจเริ่มต้นเหล่านี้จะไม่มีการใช้งานในตอนแรก หากต้องการจัดการสถานะของแพ็กเกจเริ่มต้น คุณสามารถใช้ปลายทาง monetization.subscriptions.basePlans รวมถึงการเปิดใช้งานแพ็กเกจเริ่มต้นเพื่อให้พร้อมสำหรับการซื้อ นอกจากนี้ ปลายทาง monetization.subscriptions.basePlans.offers ยังช่วยให้คุณสร้างและจัดการข้อเสนอได้ด้วย

ข้อมูลอัปเดตเกี่ยวกับผลิตภัณฑ์

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

อัปเดตผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว

คุณใช้วิธีการต่อไปนี้เพื่อช่วยอัปเดตผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียวที่มีอยู่ได้

  • monetization.onetimeproducts.batchUpdate
  • inappproducts.patch : ปลายทางแพตช์ใช้เพื่ออัปเดตทรัพยากรบางส่วน ซึ่งหมายความว่าคุณสามารถอัปเดตช่องที่เฉพาะเจาะจงซึ่งระบุไว้ในเนื้อหาคำขอได้ โดยปกติแล้ว ระบบจะใช้ปลายทางแพตช์เมื่อคุณต้องการอัปเดตฟิลด์ของทรัพยากรเพียงไม่กี่ฟิลด์เท่านั้น
  • inappproducts.update : ปลายทางการอัปเดตใช้เพื่ออัปเดตทรัพยากรทั้งหมด ซึ่งหมายความว่าคุณจะต้องส่งออบเจ็กต์ทรัพยากรทั้งหมดในเนื้อหาคำขอ โดยปกติแล้ว ระบบจะใช้ปลายทางการอัปเดตเมื่อคุณต้องการอัปเดตช่องทั้งหมดในทรัพยากร เมื่อตั้งค่าพารามิเตอร์ allowMissing เป็น true และรหัสสินค้าที่ระบุยังไม่มีอยู่ ปลายทางจะแทรกสินค้าแทนที่จะดำเนินการไม่สำเร็จ
  • inappproducts.batchUpdate : นี่คือเวอร์ชันกลุ่มของปลายทางการอัปเดต ซึ่งช่วยให้คุณแก้ไขผลิตภัณฑ์หลายรายการได้ด้วยการค้นหาเดียว ใช้ร่วมกับช่อง latencyTolerance ที่ตั้งค่าเป็น PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT เพื่อให้ได้อัตราการส่งผ่านข้อมูลที่สูงขึ้น

อัปเดตผลิตภัณฑ์ที่ต้องสมัครใช้บริการ

หากต้องการอัปเดตการสมัครใช้บริการที่มีอยู่ คุณสามารถใช้เมธอด monetization.subscriptions.patch ได้ เมธอดนี้ใช้พารามิเตอร์ที่จำเป็นต่อไปนี้

  • packageName: ชื่อแพ็กเกจของแอปที่การสมัครใช้บริการนั้นเป็นของแอปดังกล่าว
    • productId: รหัสสินค้าที่ไม่ซ้ำกันของการสมัครใช้บริการ
  • regionsVersion: เวอร์ชันการกำหนดค่าภูมิภาค

คุณต้องระบุพารามิเตอร์ updateMask เว้นแต่คุณจะสร้างการสมัครใช้บริการใหม่โดยใช้พารามิเตอร์ allowMissing พารามิเตอร์นี้เป็นรายการฟิลด์ที่คั่นด้วยคอมมาซึ่งคุณต้องการอัปเดต

เช่น หากต้องการอัปเดตข้อมูลของผลิตภัณฑ์ที่ต้องสมัครใช้บริการเท่านั้น คุณจะต้องระบุช่อง listings เป็นพารามิเตอร์ updateMask

คุณสามารถใช้ monetization.subscriptions.batchUpdate เพื่ออัปเดตการสมัครใช้บริการหลายรายการพร้อมกันได้ ใช้ร่วมกับช่อง latencyTolerance ที่ตั้งค่าเป็น PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT เพื่อให้ได้อัตราการส่งผ่านข้อมูลที่สูงขึ้น

หากต้องการเปิดใช้งาน ปิดใช้งาน ลบแพ็กเกจเริ่มต้น หรือย้ายข้อมูลสมาชิกไปยังเวอร์ชันราคาแพ็กเกจเริ่มต้นล่าสุด ให้ใช้ปลายทาง monetization.subscriptions.basePlans

นอกจากนี้ คุณยังอัปเดตข้อเสนอของแพ็กเกจเริ่มต้นได้ด้วยเมธอด monetization.subscriptions.basePlans.offers.patch

การปรับยอดแคตตาล็อก

ไม่ว่าคุณจะเลือกอัปเดตแคตตาล็อก Google Play ทุกครั้งที่แคตตาล็อกของแบ็กเอนด์มีการเปลี่ยนแปลงหรือเป็นระยะๆ หากคุณมีระบบการจัดการแคตตาล็อกหรือฐานข้อมูลนอกแคตตาล็อกของ Google Play ก็อาจมีสถานการณ์ที่แคตตาล็อกไม่ซิงค์กับการกำหนดค่าแอปใน Play ซึ่งอาจเกิดจากการเปลี่ยนแปลงแคตตาล็อกด้วยตนเองในกรณีฉุกเฉินในคอนโซล การหยุดทำงานของระบบการจัดการแคตตาล็อก หรืออาจเป็นเพราะคุณสูญเสียข้อมูลล่าสุด

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

การพิจารณาระบบที่แตกต่างกัน

เราขอแนะนำให้สร้างระบบ Diff เพื่อตรวจหาความไม่สอดคล้องกันและปรับยอดทั้ง 2 ระบบ สิ่งที่ควรพิจารณาเมื่อสร้างระบบ Diff เพื่อช่วยให้แคตตาล็อกซิงค์กันอยู่เสมอมีดังนี้

  • ทำความเข้าใจโมเดลข้อมูล: ขั้นตอนแรกคือการทำความเข้าใจโมเดลข้อมูลของ CMS ของนักพัฒนาแอปและ Google Play Developer API ซึ่งรวมถึงการทราบประเภทข้อมูลต่างๆ ที่จัดเก็บไว้ในแต่ละระบบ และวิธีที่องค์ประกอบข้อมูลต่างๆ แมปเข้าด้วยกัน
  • กำหนดกฎ Diff: เมื่อเข้าใจโมเดลข้อมูลแล้ว คุณต้องกำหนดกฎ Diff กฎเหล่านี้จะกำหนดวิธีเปรียบเทียบข้อมูลในทั้ง 2 ระบบ เช่น คุณอาจต้องการจับคู่รหัสสินค้าและเปรียบเทียบแอตทริบิวต์หลักของการสมัครใช้บริการ รวมถึงแพ็กเกจเริ่มต้นและข้อเสนอที่เกี่ยวข้อง
  • ใช้อัลกอริทึม Diff: เมื่อกำหนดกฎ Diff แล้ว คุณต้องใช้อัลกอริทึม Diff อัลกอริทึมนี้จะนำข้อมูลจากทั้ง 2 ระบบมาเปรียบเทียบกันตามกฎที่คุณกำหนดไว้ หากต้องการรับข้อมูลแคตตาล็อก จาก Google Play คุณสามารถใช้เมธอด monetization.onetimeproducts.list, monetization.onetimeproducts.batchGet, inappproducts.list, inappproducts.batchGet, monetization.subscriptions.list และ monetization.subscriptions.batchGet
  • สร้างรายงานความแตกต่าง: อัลกอริทึมความแตกต่างจะสร้างรายงานความแตกต่าง รายงานนี้จะแสดงความแตกต่างระหว่างทั้ง 2 ระบบ
  • ปรับความแตกต่าง: เมื่อสร้างรายงานความแตกต่างแล้ว คุณต้องแก้ไขความแตกต่าง ซึ่งอาจเกี่ยวข้องกับการอัปเดตข้อมูลใน CMS หรืออาจเกี่ยวข้องกับการอัปเดตข้อมูลในฝั่ง Google Play โดยใช้ปลายทางการจัดการแคตตาล็อก Developer API ทั้งนี้ขึ้นอยู่กับวิธีที่คุณอัปเดตแคตตาล็อกตามปกติ หากต้องการปรับยอดสินค้าที่ไม่ซิงค์ ให้ใช้ปลายทางการอัปเดตตามที่อธิบายไว้ในส่วนการอัปเดตสินค้า

การเลิกใช้งานผลิตภัณฑ์

Google Play Developer API มีเมธอดต่อไปนี้เพื่อช่วยคุณเลิกใช้งานไอเทม

สำหรับผลิตภัณฑ์แบบเรียกเก็บเงินครั้งเดียว

สำหรับผลิตภัณฑ์ที่ต้องสมัครใช้บริการ

  • monetization.subscriptions.delete สำหรับการสมัครใช้บริการ คุณจะนำการสมัครใช้บริการออกไม่ได้เมื่อเปิดใช้งานแพ็กเกจเริ่มต้นอย่างน้อย 1 รายการแล้ว

การเลิกใช้งานผลิตภัณฑ์อาจจำเป็นในสถานการณ์ต่างๆ เช่น

  • สร้างโดยไม่ตั้งใจ
  • การปิดให้บริการฟีเจอร์หรือบริการ

เราขอแนะนำให้รวมการเลิกใช้งานผลิตภัณฑ์ไว้ในกลยุทธ์การจัดการแคตตาล็อก