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

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

אובייקט שמייצג צמד של קו רוחב/אורך. מבוטא כצמד זוגות כדי לייצג מעלות קו רוחב ומעלות קו אורך. אם לא צוין אחרת, האובייקט חייב לעמוד ב תקן 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

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