Method: albums.addEnrichment

הוספת העשרה במיקום מסוים באלבום מוגדר.

בקשת HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
albumId

string

חובה. מזהה האלבום שאליו תתווסף העשרה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "newEnrichmentItem": {
    object (NewEnrichmentItem)
  },
  "albumPosition": {
    object (AlbumPosition)
  }
}
שדות
newEnrichmentItem

object (NewEnrichmentItem)

חובה. ההעשרה שרוצים להוסיף.
albumPosition

object (AlbumPosition)

חובה. המיקום באלבום שבו יש להוסיף את ההעשרה.

גוף התשובה

פריט ההעשרה שנוצר.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "enrichmentItem": {
    object (EnrichmentItem)
  }
}
שדות
enrichmentItem

object (EnrichmentItem)

פלט בלבד. העשרה שנוספה.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

NewEnrichmentItem

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

ייצוג ב-JSON 
{

  // Union field enrichment can be only one of the following:
  "textEnrichment": {
    object (TextEnrichment)
  },
  "locationEnrichment": {
    object (LocationEnrichment)
  },
  "mapEnrichment": {
    object (MapEnrichment)
  }
  // End of list of possible types for union field enrichment.
}
שדות
שדה האיחוד enrichment. העשרה להוספה לאלבום. זה יכול להיות טקסט, מיקום או מפה. הערך של enrichment יכול להיות רק אחת מהאפשרויות הבאות:
textEnrichment

object (TextEnrichment)

הטקסט שיתווסף לאלבום.
locationEnrichment

object (LocationEnrichment)

המיקום שרוצים להוסיף לאלבום.
mapEnrichment

object (MapEnrichment)

המפה שרוצים להוסיף לאלבום.

TextEnrichment

העשרה שמכילה טקסט.

ייצוג ב-JSON 
{
  "text": string
}
שדות
text

string

הטקסט של פריט ההעשרה הזה.

LocationEnrichment

העשרה שמכילה מיקום יחיד.

ייצוג JSON 
{
  "location": {
    object (Location)
  }
}
שדות
location

object (Location)

המיקום של פריט העשרה הזה.

מיקום

מייצג מיקום פיזי.

ייצוג ב-JSON 
{
  "locationName": string,
  "latlng": {
    object (LatLng)
  }
}
שדות
locationName

string

שם המיקום שיוצג.
latlng

object (LatLng)

המיקום של המיקום במפה.

LatLng

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

ייצוג JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].
longitude

number

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

MapEnrichment

העשרה שמכילה מפה, שמציגה את מיקומי המוצא והיעד.

ייצוג JSON 
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
שדות
origin

object (Location)

מיקום המקור של פריט ההעשרה הזה.
destination

object (Location)

מיקום היעד של פריט ההעשרה הזה.

EnrichmentItem

פריט העשרה.

ייצוג ב-JSON 
{
  "id": string
}
שדות
id

string

מזהה של פריט העשרה.