הוספת הטבות

התכונה 'העשרה' מאפשרת לאפליקציה שלכם לקבוע את המבנה והתצוגה של התמונות באלבום ב-Google Photos. הם מאפשרים לכם להציג למשתמש הקשר נוסף באמצעות הערות טקסט או מיקום, ולסדר או לקבץ תמונות כדי לספר סיפור.

היקף ההרשאה הנדרש

כדי להוסיף תוכן לאלבומים שנוצרו על ידי האפליקציה, צריך את ההיקף photoslibrary.appendonly. מידע נוסף על היקפים זמין במאמר היקפי הרשאה.

סוגי ההעשרה

ב-Google Photos יש תמיכה בשלושה סוגים של תוכן נוסף באלבומים: טקסט, מיקומים ומפות.

העשרת טקסט

העשרת טקסט היא מחרוזת טקסט פשוט שאפשר להוסיף כדי להוסיף הערות לאלבום.

העשרת נתוני מיקום

העשרת מיקום היא סמן ושם של מקום שאפשר להוסיף כדי להוסיף הערה למיקום.

העשרת המפה

העשרת מפה היא מפה עם מקור ויעד שצוינו, שאפשר להוסיף לאלבום.

מיקומים

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

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

תחילת האלבום

ניתן להוסיף פריט מדיה/העשרה לתחילת האלבום כמיקום מוחלט.

סוף האלבום

אפשר להוסיף פריט מדיה/עשר לאלבום כמיקום מוחלט.

ביחס לפריט המדיה

ניתן להוסיף פריט מדיה/העשרה ביחס לפריט מדיה שמתחיל אחרי המיקום שלו באלבום.

ביחס לפריט העשרה

ניתן להוסיף פריט מדיה/העשרה ביחס לפריט העשרה שמתחיל אחרי המיקום שלו באלבום.

הוספת העשרה לאלבום

אפשר להוסיף עשירות אחת בכל פעם, וצריך להוסיף אותה למיקום מסוים באלבום. כדי להוסיף תוכן לאלבום, קוראים ל-albums.addEnrichment.

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

REST

זוהי בקשת POST:

POST https://photoslibrary.googleapis.com/v1/albums/album-id:addEnrichment
Content-type: application/json
Authorization: Bearer oauth2-token
request-body

גוף הבקשה מורכב מפריט ההעשרה ומהמיקום שלו:

{
  "newEnrichmentItem": {
    enrichment-to-be-added
  },
  "albumPosition": {
    position-of-enrichment
}

זוהי דוגמה לתשובה:

{
  "enrichmentItem": {
    "id": "enrichment-item-id",
  }
}

העשירותות הנתמכות

העשרת טקסט

העשרות טקסט מכילות מחרוזת טקסט אחת (עד 1,000 תווים), כפי שמוצג בדוגמה הבאה:

REST

{
  "text": "Text to be shown"
}

Java

// Use the NewEnrichmentItemFactory helper to create a text enrichment item
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createTextEnrichment("text to be shown");

PHP

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithText("text to be shown");

העשרת נתוני מיקום

העשירות של מיקומים מורכבת משם מיקום שרירותי וממיקום קו הרוחב וקו האורך. השדה locationName מוגבל ל-500 תווים.

REST

{
  "location": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a location enrichment
// with the name, latitude, and longitude of the location
NewEnrichmentItem newEnrichmentItem =
    NewEnrichmentItemFactory.createLocationEnrichment("Australia", -21.197, 95.821);

PHP

// Create a new location object and set the name, latitude, and longitude of the location
$newLocation = new Location();
$newLocation->setLocationName("Australia");
$newLocation->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$newEnrichmentItem = PhotosLibraryResourceFactory::newEnrichmentItemWithLocation($newLocation);

העשרת המפה

בשיפורים של מפות מוצגים שני מיקומים, כל אחד מהם מורכב משם, קו הרוחב וקווי האורך. בדומה להעשרת המיקום, השדה locationName ב-origin והשדה destination מוגבלים ל-500 תווים.

REST

{
  "origin": {
    "locationName": "Australia",
    "latlng": {
      "latitude": "-21.197",
      "longitude": "95.821"
    }
  },
  "destination": {
    "locationName": "San Francisco",
    "latlng": {
      "latitude": "37.757",
      "longitude": "122.507"
    }
  }
}

Java

// Use the NewEnrichmentItemFactory helper to create a map enrichment item for
// an origin and a destination location
NewEnrichmentItem newEnrichmentItem = NewEnrichmentItemFactory.createMapEnrichment(
    "Australia", -21.197, 95.821, // origin
    "San Francisco", 37.757, 122.507 // destination
);

PHP

// Create two new location objects to create a map enrichment item
// for an origin and a destination location
$locationAustralia = new Location();
$locationAustralia->setLocationName("Australia");
$locationAustralia->setLatlng((new LatLng())->setLatitude(-21.197)->setLongitude(95.821));

$locationSanFrancisco = new Location();
$locationSanFrancisco->setLocationName("San Francisco");
$locationSanFrancisco->setLatlng((new LatLng())->setLatitude(37.757)->setLongitude(122.507));

$newEnrichmentItem =
  PhotosLibraryResourceFactory::newEnrichmentItemWithMap($locationAustralia, $locationSanFrancisco);

מיקומים נתמכים

תחילת האלבום

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

REST

{
  "position": "FIRST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createFirstInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::FIRST_IN_ALBUM);

סוף האלבום

המיקום LAST_IN_ALBUM מתייחס לסוף האלבום. הפריטים שנמצאים כאן מוצגים למשתמש אחרונים.

REST

{
  "position": "LAST_IN_ALBUM",
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createLastInAlbum();

PHP

$albumPosition = new AlbumPosition();
$albumPosition->setPosition(PositionType::LAST_IN_ALBUM);

ביחס לפריט המדיה

ציון המיקום relativeMediaItem מתייחס למיקום ביחס לפריט מדיה. הפריטים מתווספים אחרי פריט המדיה שצוין.

REST

{
  "position": "after-media-item",
  "relativeMediaItemId": "media-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterMediaItem(mediaItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterMediaItem($mediaItemId);

ביחס לפריט העשרה

ציון הערך relativeEnrichmentItemId מתייחס למיקום ביחס לפריט העשרה. הפריטים מתווספים אחרי פריט ההעשרה שצוין.

REST

{
  "position": "after-enrichment-item",
  "relativeEnrichmentItemId": "enrichment-item-id"
}

Java

AlbumPosition albumPosition = AlbumPositionFactory.createAfterEnrichmentItem(enrichmentItemId);

PHP

$albumPosition = PhotosLibraryResourceFactory::albumPositionAfterEnrichmentItem($enrichmentItemId);

שינוי העשירות

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