ניהול קטלוג המוצרים

במדריך הזה מוסבר איך להשתמש בממשק ה-API של Google Play למפתחים כדי ליצור ולנהל קטלוג מוצרים לאפליקציה ב-Play.

כדי למכור מוצרים באפליקציה דרך מערכת החיוב של Google Play, צריך להגדיר קטלוג עם כל המוצרים שרוצים שהמשתמשים יוכלו לרכוש. אפשר לעשות את זה דרך Play Console, או להפוך את ניהול הקטלוג לאוטומטי באמצעות ממשק ה-API של Google Play למפתחים. אוטומציה יכולה לעזור לכם לוודא שהקטלוג תמיד עדכני, ולהתאים אותו לקטלוגים גדולים שבהם תיאום ידני הוא לא מעשי. במדריך הזה נסביר איך להשתמש ב-Play Developer API כדי ליצור ולנהל קטלוג מוצרים לאפליקציה ב-Play. במדריך הכנה מוסבר איך להגדיר את Google Play Developer API לשילוב בקצה העורפי.

ממשקי API לניהול קטלוגים

כדי לקרוא על סוגי המוצרים השונים שאפשר למכור באמצעות מערכת החיוב של Google Play, קראו את המאמר הסבר על סוגי המוצרים באפליקציה ושיקולים בנוגע לקטלוג. ‫Google מציעה שתי קבוצות עיקריות של ממשקי API לניהול קטלוגים ב-Play, בהתאם לשתי קטגוריות המוצרים העיקריות:

  • מוצרים בחיוב חד-פעמי
  • מוצרים מסוג מינוי

מוצרים בחיוב חד-פעמי

מוצרים בחיוב חד-פעמי (שנקראו בעבר מוצרים באפליקציה) משתמשים במודל האובייקטים של מוצרים בחיוב חד-פעמי, שמאפשר להגדיר כמה אפשרויות רכישה ומבצעים למוצרים בחיוב חד-פעמי. מודל האובייקטים של מוצרים בחיוב חד-פעמי מאפשר לכם למכור מוצרים בצורה גמישה יותר, ומפחית את המורכבות של ניהול המוצרים. המוצרים הקיימים באפליקציה יועברו למודל האובייקטים של מוצרים בחיוב חד-פעמי. מידע נוסף זמין במאמר בנושא העברת מוצרים באפליקציה.

נקודות הקצה monetization.onetimeproducts ו-inappproducts מאפשרות לנהל מוצרים בחיוב חד-פעמי מה-backend. זה כולל יצירה, עדכון ומחיקה של מוצרים, וניהול המחירים והזמינות. בהתאם לאופן שבו אתם מטפלים ברכישות של מוצרים בחיוב חד-פעמי, אתם יכולים ליצור מודל של מוצרי צריכה (שאפשר לקנות כמה פעמים שרוצים) או של הרשאות קבועות (שאותו משתמש לא יכול לקנות פעמיים). אתם יכולים להחליט אילו מוצרים בחיוב חד-פעמי יהיו ניתנים לצריכה ואילו לא.

מוצרים מסוג מינוי

נקודת הקצה monetization.subscriptions עוזרת לכם לנהל מוצרים מסוג מינוי מה-backend של המפתח. אתם יכולים לבצע פעולות כמו יצירה, עדכון ומחיקה של מינויים, או לשלוט בזמינות ותמחור לפי אזור (RAAP). בנוסף לנקודת הקצה 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. ממשקי ה-API של Google Play למפתחים מאורגנים בקטגוריות שנקראות קטגוריות, ולכל קטגוריה יש מגבלת מכסה משלה לדקה. מידע נוסף זמין במאמר מכסות.
  2. בנוסף, בנקודות הקצה (endpoints) לשינוי מוצרים יש מגבלה של 7,200 שאילתות לשעה. המגבלה הזו חלה על מוצרים בחיוב חד-פעמי ועל מינויים, ועל כל בקשות השינוי, כולל יצירה, עדכון, הפעלה ומחיקה. הפעלות של שיטות לשינוי באצווה נספרות כשאילתה אחת במכסה הזו, בלי קשר למספר הבקשות הנפרדות שנכללות או לרגישות שלהן לזמן האחזור.
  3. בשינויים שרגישים לזמן האחזור יש גם מגבלה של 7,200 שינויים בשעה. בשיטות של אצווה, כל בקשת שינוי בתצוגת עץ נספרת בנפרד לצורך המכסה הזו. למכסה הזו יש השלכות מעשיות רק על משתמשים ב-API של עדכונים באצווה שמבצעים עדכונים שרגישים לזמן האחזור, כי במקרים אחרים מכסה 2 תנוצל לפני המכסה הזו או במקביל אליה.

הנה כמה דוגמאות שממחישות את השימוש במכסות בבקשות שונות:

  • בקשת get אחת לאחזור פריט אחד תצרוך טוקן אחד ממכסה 1, ואף טוקן ממכסות 2 ו-3 (כי הן קשורות רק לנקודות קצה לשינוי).
  • בקשת אצווה אחת (get) לאחזור של עד 100 פריטים תצרוך גם היא טוקן אחד ממכסה 1, ואפס טוקנים ממכסות 2 ו-3.
  • בקשת modification אחת לפריט אחד תצרוך טוקן אחד ממכסה 1 וטוקן אחד ממכסה 2. אם הבקשה רגישה לזמן אחזור, היא תצרוך גם אסימון אחד ממכסה 3. מכיוון שלמכסה ג' יש אותה מגבלה כמו למכסה 2, אין לה השלכות מעשיות על משתמשים שמשתמשים רק בשיטות לשינוי יחיד.
  • בקשת אצווה modification ל-100 פריטים עם סבילות לזמן אחזור תצרוך טוקן אחד ממכסה 1 וטוקן אחד ממכסה 2. הגדרת המכסה הזו אמורה לאפשר מרווח מספיק כדי שהקטלוג יישאר מעודכן, אבל אם האלגוריתם שלכם לא מודע למכסה הזו וחורג מהקצב הזה, יכול להיות שתקבלו שגיאה על כל קריאה נוספת.
  • בקשת אצווה אחת (modification) ל-100 פריטים שרגישים לזמן אחזור תצרוך אסימון אחד ממכסה 1, אסימון אחד ממכסה 2 ו-100 אסימונים ממכסה 3.

המלצות לשימוש ב-Catalog Management API

אם תפעלו לפי ההנחיות האלה, תוכלו לבצע אופטימיזציה של האינטראקציות עם ה-API וליהנות מחוויית ניהול קטלוג חלקה ויעילה.

מעקב אחרי השימוש

חשוב לשים לב לתהליכים שצורכים הרבה משאבים. לדוגמה, בתחילת השילוב, סביר להניח שנקודות הקצה לניהול הקטלוג יצרכו יותר מכסה כדי ליצור את הקטלוג הראשוני המלא. אם אתם קרובים למגבלת השימוש הכוללת, זה עלול להשפיע על השימוש בייצור של נקודות קצה אחרות, כמו ה-API של סטטוס הרכישה. כדי לוודא שלא חרגתם מהמכסות של ה-API, אתם צריכים לעקוב אחרי ניצול המכסות. יש כמה דרכים לעקוב אחרי השימוש. לדוגמה, אתם יכולים להשתמש בלוח הבקרה של המכסות ב-Cloud APIs, או בכל כלי אחר לבחירתכם לפיקוח על API, בין אם הוא פנימי או של צד שלישי.

אופטימיזציה של השימוש במכסת ה-API

כדי לצמצם את הסיכוי לשגיאות ב-API, מומלץ מאוד לבצע אופטימיזציה של צריכת הקצב. כדי להטמיע את זה בצורה יעילה, מומלץ:

  • בחרו את השיטה המתאימה לניהול הקטלוג. אחרי שמבינים את מכסת ה-API, צריך לבחור את האסטרטגיה המתאימה לאפליקציה כדי להשיג את יעדי ניהול הקטלוג ביעילות.
  • בצעו רק את מספר הקריאות המינימלי שנדרש כדי לשקף את השינויים.
  • אל תשלחו קריאות מיותרות או לא נחוצות לשינוי ממשקי ה-API. יכול להיות שתצטרכו לנהל יומן שינויים בקטלוג שלכם בקצה העורפי.
  • לא לחרוג מהמגבלה השעתית של שינוי מוצרים – 7,200 שאילתות. יכול להיות שתרצו ליצור תהליכי סנכרון שדורשים מכם לבצע מספר גדול של שינויים במוצרים בפרק זמן קצר (לדוגמה, יצירת קטלוג ראשוני). אם אתם צופים שהתהליכים האלה יחרגו מהמגבלה השעתית, כדאי להטמיע זמני המתנה לפי הצורך כדי להאט את השימוש לרמה בטוחה. כדי להשיג קצב העברה גבוה יותר, כדאי להשתמש בשיטות אצווה עם עדכונים שמאפשרים זמן אחזור.
  • התכוננו מראש להרחבת הפעילות. ככל שהאפליקציה תגדל, יכול להיות שתצטרכו להגדיל את השימוש ב-API ובנקודות הקצה השונות. במסמכי התיעוד של ממשק ה-API של Google Play למפתחים מוסבר איך להגדיל את המכסה כשמתקרבים למגבלת השימוש.
  • תזמון אסטרטגי של תהליכים כבדים. נסו לתזמן את התהליכים הכבדים של הקטלוג כך שלא יתנגשו עם שיאי השימוש הקריטיים. לדוגמה, אתם יכולים להימנע מהפעלת סנכרון מלא של הקטלוג בזמני השיא של המכירות במהלך השבוע.

הוספת לוגיקה לטיפול בשגיאות שקשורות למכסות

לא משנה כמה יעיל הלוגיקה של ניהול הקטלוג, צריך לוודא שהיא עמידה בפני מגבלות מכסה בלתי צפויות, כי המכסה היומית משותפת לנקודות קצה שמשמשות במודולים עצמאיים של השילוב. חשוב לכלול שגיאות של ויסות נתונים (throttling) של מכסות בטיפול בשגיאות, ולהטמיע את ההמתנות המתאימות. כל קריאה לממשקי ה-API של Google Play למפתחים תפיק תגובה. אם הקריאה נכשלת, תקבלו תגובת כישלון שכוללת קוד סטטוס של תגובת 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"
  } ],
}

הטמעה של ניהול קטלוגים

מפתחים משתמשים בנקודות הקצה לפרסום מוצרים של ממשק ה-API של Google Play למפתחים כדי לסנכרן את הקטלוג בין הקצה העורפי שלהם לבין Google Play. כדי ליצור חוויית משתמש טובה יותר, חשוב לוודא שהקטלוג ב-Google Play תמיד מעודכן במידע העדכני ביותר מהקטלוג בקצה העורפי. לדוגמה:

  • תוכלו לעיין ברשימה המלאה של המבצעים הזמינים, ולנהל את התגים של המבצעים והמינויים הבסיסיים כדי להשפיע על הלוגיקה של הזכאות שלכם ושל הצגת המבצעים.
  • אתם יכולים לבדוק את המחירים שנקבעו ופרטי המוצרים השונים שהמשתמשים רואים בפלטפורמות השונות, ולוודא שהם עקביים.
  • פרטי המוצר יהיו זמינים בקצה העורפי שלכם בזמן עיבוד רכישות חדשות, בלי שתצטרכו להגדיל את זמן האחזור ואת הסיכון לכשלים על ידי ביצוע קריאות נוספות לממשק ה-API של Google Play למפתחים במהלך תהליכים קריטיים של המשתמשים.

יש מגבלות ושיקולים מסוימים שצריך להביא בחשבון כשיוצרים קטלוג מוצרים ב-Google Play. אחרי שתבינו את המגבלות האלה ותחליטו איך אתם רוצים לבנות את הקטלוג, תוכלו לבחור את אסטרטגיית הסנכרון.

אסטרטגיות לסנכרון קטלוגים

נקודות הקצה לפרסום של ממשק ה-API של Google Play למפתחים מאפשרות לכם לעדכן את הקטלוג כשיש שינויים. לפעמים צריך להשתמש בגישה של עדכונים תקופתיים, שבה שולחים קבוצה של שינויים באותו תהליך. כל גישה דורשת בחירות עיצוביות שונות. כל אסטרטגיית סנכרון תתאים לתרחישים מסוימים יותר מאשר לאחרים, ויכול להיות שיהיה לכם מערך צרכים שיחייב את שתי האסטרטגיות, בהתאם למצב.

לפעמים תרצו לעדכן מוצר ברגע שתגלו שינוי חדש, למשל כדי לעבד עדכון דחוף של מוצר (למשל, אם צריך לתקן מחיר שגוי בהקדם האפשרי). במקרים אחרים, אפשר להשתמש בסנכרון תקופתי ברקע כדי לוודא שהקטלוגים של הקצה העורפי ושל Play תמיד עקביים. כאן מפורטים כמה תרחישים נפוצים שבהם כדאי להטמיע את האסטרטגיות השונות לניהול קטלוגים.

מתי לשלוח עדכונים כשהקטלוג המקומי משתנה

כדי לצמצם את הפערים, מומלץ לעדכן את הנתונים ברגע שמתבצע שינוי כלשהו בקטלוג המוצרים בקצה העורפי.

כדאי להשתמש בסוג הזה של עדכונים במקרים הבאים:

  • אתם צריכים לוודא שפרטי המוצרים שלכם תמיד עדכניים.
  • אתם צריכים לבצע כמה שינויים במוצרים שלכם בכל יום.
  • אתם צריכים לעדכן מוצרים שכבר נמצאים בייצור ונמכרים.

הגישה הזו פשוטה יותר ליישום, ומאפשרת לכם לסנכרן את הקטלוג עם חלון הפערים הקטן ביותר.

מתי כדאי להשתמש בעדכונים תקופתיים

עדכונים תקופתיים פועלים באופן אסינכרוני לעריכת המוצר בקצה העורפי, והם אפשרות טובה במקרים הבאים:

  • אתם לא צריכים לדאוג לעדכן את המוצרים בהתראה קצרה.
  • אתם צריכים לתכנן עדכון מספר פריטים בו-זמנית או תהליכי התאמה.
  • כבר יש לכם מערכת לניהול תוכן או קטלוגים שבה אתם מנהלים את המוצרים הדיגיטליים שלכם, והיא מעדכנת את הקטלוג באופן קבוע.

אם יש לכם קטלוגים גדולים, כדאי להשתמש בשיטות של אצווה עם עדכונים שמאפשרים זמן אחזור כדי להשיג תפוקה מקסימלית.

יצירת קטלוג מוצרים

אם יש לכם קטלוג גדול שאתם רוצים להעלות ל-Google Play, כדאי להפוך את ההעלאה הראשונית לאוטומטית. התהליך הכבד הזה פועל בצורה הטובה ביותר אם משתמשים באסטרטגיה תקופתית בשילוב עם שיטות אצווה (batch) שמאפשרות זמן אחזור.

יצירת מוצרים בחיוב חד-פעמי

כדי ליצור קטלוג מוצרים בחיוב חד-פעמי בפעם הראשונה, מומלץ להשתמש ב-monetization.onetimeproducts.batchUpdate או ב-inapp_products.insert, כשהשדה allowMissing מוגדר ל-true והשדה latencyTolerance מוגדר ל-PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. כך אפשר לצמצם את הזמן שנדרש ליצירת הקטלוג במסגרת מגבלות המכסה.

יצירת מוצרים מסוג מינוי

כדי ליצור קטלוג גדול של מינויים ראשוניים, מומלץ להשתמש ב-method‏ monetization.subscriptions.batchUpdate, להגדיר את השדה allowMissing לערך true ואת השדה latencyTolerance לערך PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. כך אפשר לצמצם את הזמן שנדרש ליצירת הקטלוג במסגרת מגבלות המכסה.

בקטלוגים קטנים יותר של מינויים, Play Developer API מספק את ה-method monetization.subscriptions.create. אפשר גם ליצור מינויים באמצעות השיטה monetization.subscriptions.patch עם הפרמטר allowMissing, כמו שמתואר בקטע "עדכוני מוצרים".

כל השיטות הקודמות יוצרות מינויים יחד עם התוכניות הבסיסיות שלהם (שמסופקות בתוך האובייקט Subscription). המינויים הבסיסיים האלה לא פעילים בהתחלה. כדי לנהל את הסטטוס של מינויים בסיסיים, אתם יכולים להשתמש בנקודת הקצה monetization.subscriptions.basePlans, כולל הפעלה של מינוי בסיסי כדי שיהיה זמין לרכישה. בנוסף, נקודת הקצה monetization.subscriptions.basePlans.offers מאפשרת ליצור ולנהל מבצעים.

עדכוני מוצרים

השיטות הבאות מאפשרות לכם לשנות ביעילות את המוצרים הקיימים, כדי לוודא שהמוצרים שאתם מציעים תואמים לשינויים האחרונים שביצעתם.

עדכון מוצרים בחיוב חד-פעמי

אתם יכולים להשתמש בשיטות הבאות כדי לעדכן מוצרים קיימים בחיוב חד-פעמי.

  • monetization.onetimeproducts.batchUpdate
  • ‫inappproducts.patch: נקודת הקצה (endpoint) של התיקון משמשת לעדכון חלקי של משאב. כלומר, אפשר לעדכן שדות ספציפיים שמציינים בגוף הבקשה. בדרך כלל משתמשים בנקודת הקצה patch כשצריך לעדכן רק כמה שדות של משאב.
  • ‫inappproducts.update: נקודת הקצה של העדכון משמשת לעדכון משאב בשלמותו. כלומר, צריך לשלוח את כל אובייקט המשאב בגוף הבקשה. בדרך כלל משתמשים בנקודת הקצה לעדכון כשצריך לעדכן את כל השדות במשאב. כשהפרמטר allowMissing מוגדר לערך true ומזהה המוצר שסופק לא קיים, נקודת הקצה תוסיף את המוצר במקום להיכשל.
  • ‫inappproducts.batchUpdate: זוהי גרסת אצווה של נקודת הקצה לעדכון, שמאפשרת לשנות כמה מוצרים באמצעות שאילתה אחת. כדי להשיג תפוקה גבוהה יותר, משתמשים בו יחד עם השדה latencyTolerance שמוגדר לערך PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT.

עדכון מוצרים מסוג מינוי

כדי לעדכן מינויים קיימים, אפשר להשתמש ב-method‏ monetization.subscriptions.patch. השיטה הזו מקבלת את הפרמטרים הנדרשים הבאים:

  • ‫packageName: שם החבילה של האפליקציה שהמינוי שייך לה.
    • ‫productId: מזהה המוצר הייחודי של המינוי.
  • ‫regionsVersion: גרסת ההגדרות של האזור.

אם אתם לא יוצרים מינוי חדש באמצעות הפרמטר allowMissing, אתם צריכים לספק את הפרמטר updateMask. הפרמטר הזה הוא רשימה מופרדת בפסיקים של שדות שרוצים לעדכן.

לדוגמה, אם רוצים לעדכן רק דף של מוצר מסוג מינוי, צריך לציין את השדה listings בפרמטר updateMask.

אפשר להשתמש ב-monetization.subscriptions.batchUpdate כדי לעדכן כמה מינויים בו-זמנית. כדי להשיג תפוקה גבוהה יותר, משתמשים בו יחד עם השדה latencyTolerance שמוגדר לערך PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT.

כדי להפעיל, להשבית או למחוק מינויים בסיסיים, או כדי להעביר מנויים לגרסאות המחיר העדכניות ביותר של המינוי הבסיסי, משתמשים בנקודת הקצה monetization.subscriptions.basePlans.

בנוסף, אפשר לעדכן את המבצעים של מינויי הבסיס באמצעות השיטה monetization.subscriptions.basePlans.offers.patch.

התאמת קטלוגים

אם יש לכם מערכת לניהול קטלוגים או מסד נתונים מחוץ לקטלוג של Google Play, יכול להיות שיהיו מצבים שבהם הם לא יהיו מסונכרנים עם הקטלוג בהגדרות של האפליקציות ב-Play. זה יכול לקרות גם אם אתם מעדכנים את הקטלוג ב-Google Play בכל פעם שהקטלוג של ה-backend משתנה, וגם אם אתם מעדכנים אותו מדי פעם. יכול להיות שזה קרה בגלל שינויים ידניים דחופים בקטלוג ב-Console, הפסקה זמנית בשירות של מערכת ניהול הקטלוגים או אובדן של הנתונים האחרונים.

כדי למנוע חלון זמן ממושך של חוסר התאמה, אתם יכולים ליצור תהליך התאמה של הקטלוג.

שיקולים לגבי מערכת ההשוואה

מומלץ לבנות מערכת diff כדי לזהות חוסר עקביות ולתאם בין שתי המערכות. כדי לשמור על סנכרון בין הקטלוגים, כדאי להביא בחשבון את הדברים הבאים כשיוצרים מערכת diff:

  • הבנת מודלי הנתונים: השלב הראשון הוא להבין את מודלי הנתונים של מערכת ניהול התוכן של המפתח ושל ממשק ה-API של Google Play למפתחים. זה כולל הכרת סוגי הנתונים השונים שמאוחסנים בכל מערכת, והאופן שבו רכיבי הנתונים השונים ממופים זה לזה.
  • הגדרת כללי ההשוואה: אחרי שמבינים את מודלי הנתונים, צריך להגדיר את כללי ההשוואה. הכללים האלה יקבעו איך הנתונים בשתי המערכות יושוו. לדוגמה, יכול להיות שתרצו להתאים בין מזהי מוצרים ולהשוות בין מאפייני מפתח של המינוי לבין תוכניות הבסיס והמבצעים שמשויכים אליו.
  • הטמעת אלגוריתם diff: אחרי שמגדירים את כללי ה-diff, צריך להטמיע את אלגוריתם ה-diff. האלגוריתם הזה ייקח את הנתונים משתי המערכות וישווה ביניהם לפי הכללים שהגדרתם. כדי לקבל את נתוני הקטלוג מ-Google Play, אתם יכולים להשתמש בשיטות monetization.onetimeproducts.list,‏ monetization.onetimeproducts.batchGet,‏ inappproducts.list,‏ inappproducts.batchGet,‏ monetization.subscriptions.list ו-monetization.subscriptions.batchGet.
  • יצירת דוחות השוואה: אלגוריתם ההשוואה ייצור דוח השוואה. בדוח הזה יוצגו ההבדלים בין שתי המערכות.
  • יישוב ההבדלים: אחרי שיוצרים את דוח ההבדלים, צריך לפתור את ההבדלים. יכול להיות שתצטרכו לעדכן את הנתונים במערכת ניהול התוכן (CMS) או ב-Google Play באמצעות נקודות הקצה לניהול הקטלוג ב-Developer API, בהתאם לאופן שבו אתם מעדכנים את הקטלוג בדרך כלל. כדי לסנכרן מוצרים שלא מסונכרנים, משתמשים בנקודות הקצה של העדכון כמו שמתואר בקטע "עדכוני מוצרים".

הוצאה משימוש של מוצרים

ממשק ה-API של Google Play למפתחים מספק את השיטות הבאות כדי לעזור לכם להוציא מוצרים משימוש:

למוצרים בחיוב חד-פעמי:

למוצרים מסוג מינוי:

יכול להיות שתצטרכו להוציא מוצר משימוש בתרחישים שונים, למשל:

  • היצירה נעשתה בטעות.
  • הפסקת שירות או תכונה.

מומלץ לשלב את הוצאת המוצרים מהמלאי באסטרטגיית ניהול הקטלוג.