תחילת השימוש ב-Library API

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

לפני שמתחילים

תרחישים לדוגמה לשימוש ב-Library API

Library API מתאים במיוחד למקרים שבהם האפליקציה צריכה:

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

תהליך עבודה אופייני של Library API

Library API מציע פונקציות שונות, אבל תהליך עבודה נפוץ עשוי לכלול את השלבים הבאים:

  1. העלאת מדיה: אפשר להשתמש בנקודת הקצה להעלאות כדי להעלות בבטחה ביטים של תמונות או סרטונים ל-Google Photos. בשלב הזה נוצר uploadToken.

  2. יצירת פריטים של מדיה: משתמשים בשיטה mediaItems.batchCreate, ומספקים את הערך של uploadToken כדי ליצור פריטים של מדיה בספרייה של המשתמש.

  3. יצירת אלבומים (אופציונלי): משתמשים בשיטה albums.create כדי ליצור אלבומים בספרייה של המשתמש ולסדר את פריטי המדיה.

  4. ניהול אלבומים:

    • אפשר להוסיף פריטי מדיה (האפליקציה נוצרה על ידי האפליקציה) לאלבומים באמצעות albums.batchAddMediaItems.
    • הסרת קובצי מדיה מאלבומים באמצעות albums.batchRemoveMediaItems.
    • להוסיף תוכן לאלבומים (כמו שמות או מיקומים) באמצעות albums.addEnrichment.
    • אחזור מידע על אלבומים ספציפיים באמצעות albums.get.
    • הצגת רשימה של האלבומים שהאפליקציה יצרה באמצעות albums.list.

  5. גישה לתוכן שנוצר באפליקציה:

    • אחזור פרטים על פריטים ספציפיים של מדיה באמצעות mediaItems.get או mediaItems.batchGet.
    • חיפוש פריטי מדיה שהאפליקציה שלך יצרה באמצעות mediaItems.search.
    • הצגת רשימה של פריטי מדיה באלבום ספציפי שנוצר באפליקציה באמצעות mediaItems.search עם מזהה האלבום.

השלבים הבאים

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