שיטות העריכה של Google Play Developer Publishing API מאפשרות לכם להכין כמה שינויים באפליקציה שלכם ב-Google Play, ואז לפרוס את כולם בבת אחת. כדי לעשות את זה, יוצרים עריכה שמכילה את כל השינויים שרוצים לבצע באפליקציה. העריכה מכילה מידע כמו:
אילו קובצי APK משויכים לאפליקציה, ו'מסלול' לכל קובץ APK.
כל אחד מהם משויך ל'מסלול', שקובע אילו משתמשים רואים אותו. כך תוכלו לספק גרסאות אלפא ובטא של האפליקציה לבודקים. בנוסף, אתם יכולים לספק גרסה של האפליקציה בהפצה מוגבלת ('הפצה מדורגת'). הגרסה הזו מוצגת באופן אוטומטי למספר מוגבל של משתמשים באפליקציה (המספר נקבע לפי אחוז ההפצה שהגדרתם), וכך אתם יכולים להפיץ בהדרגה גרסת ייצור חדשה של האפליקציה.
גרסאות ספציפיות לשפה ולמיקום של דף האפליקציה בחנות Google Play
כל גרסה של דף האפליקציה בחנות שמותאמת ללוקאל מסוים יכולה לכלול צילומי מסך וגרפיקה שיווקית אחרת, טקסט תיאורי מותאם לשוק המקומי וכן הלאה.
כשיוצרים עריכה בפעם הראשונה, העריכה היא עותק של המצב הנוכחי של האפליקציה שמופעלת. לאחר מכן אפשר לשנות את העריכה באמצעות קריאה לשיטות Edits. כשהעריכה מוכנה, מאשרים אותה והשינויים מתעדכנים באתר. אפשר גם לצאת מהעריכה בכל שלב, לבטל את השינויים ולהשאיר את האפליקציה כמו שהיא.
אפשר להשתמש ב-API הזה רק כדי לבצע שינויים באפליקציה קיימת (שלה הועלה לפחות APK אחד). לכן, תצטרכו להעלות לפחות APK אחד דרך Play Console לפני שתוכלו להשתמש ב-API הזה. בנוסף, אי אפשר להשתמש ב-API הזה כדי לשנות את מצב האפליקציה מ'פורסמה' ל'לא פורסמה', או כדי למלא את ההסכמות המשפטיות שנדרשות לפרסום. כדי לפרסם את האפליקציה, צריך להשתמש ב-Play Console.
תהליך עבודה
בקטע הזה מוצגת הדרך הרגילה שבה משתמשים ב-Google Play Developer Publishing API Edits methods כדי לבצע שינויים באפליקציה.
יוצרים עריכה חדשה באמצעות הקריאה Edits: Insert ומציינים את האפליקציה שרוצים לשנות.
פעולה זו יוצרת עריכה חדשה של האפליקציה שצוינה. ההגדרות הראשוניות של האפליקציה – קובצי ה-APK, דפי האפליקציה בחנות, קובצי ההרחבה וכו' – מועתקות מגרסת האפליקציה שפורסמה.
מבצעים את השינויים הרצויים.
אפשר לבצע את רוב השינויים שאפשר לבצע דרך Google Play Console. כדי לעשות זאת, קוראים לשיטה המתאימה ב-Google Play Developer API ומעבירים את המזהים של האפליקציה והעריכה שרוצים לשנות. באופן ספציפי:
- אפשר להעלות חבילות APK חדשות באמצעות הקריאה אל Edits.apks: upload. חבילת ה-APK תמוקם באזור אחסון, כך שאפשר יהיה להקצות אותה למסלול בהמשך.
- אפשר להקצות קובצי APK למסלולים באמצעות הקריאה Edits.tracks:update. אפשר גם לשנות את הקצאות הערוצים לקובצי APK קיימים באמצעות הקריאה Edits.tracks:patch.
- אפשר ליצור דף אפליקציה חדש בחנות שעבר התאמה לשוק המקומי באמצעות הקריאה Edits.listings: update. אפשר לשנות רישום קיים בחנות על ידי קריאה אל Edits.listings: patch.
- אפשר להוסיף או לשנות קובצי הרחבה באמצעות קריאה לשיטות של המשאב Edits.expansionfiles.
השיטות האלה משנות את העריכה שמתבצעת, אבל לא משנות את הגרסה הפעילה של האפליקציה. אתם יכולים לבצע שינויים נוספים או לבטל את העריכה שמתבצעת בלי להשפיע על חוויית המשתמש.
שומרים את העריכה.
כשקוראים ל-Edits: commit, אם אין שגיאות אימות, כל השינויים שצוינו במשאב העריכות עוברים למצב 'פעיל', ומחליפים את המצב הנוכחי של האפליקציה. יכולות לחלוף כמה שעות עד שהשינויים האלה ייכנסו לתוקף, בדיוק כמו כשמבצעים שינויים דרך Play Console.