- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- NewEnrichmentItem
- TextEnrichment
- LocationEnrichment
- מיקום
- LatLng
- MapEnrichment
- EnrichmentItem
- רוצים לנסות?
הוספת העשרה במיקום מוגדר באלבום מוגדר.
בקשת HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:addEnrichment
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
albumId |
חובה. המזהה של האלבום שאליו רוצים להוסיף את ההעשרה. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "newEnrichmentItem": { object ( |
שדות | |
---|---|
newEnrichmentItem |
חובה. ההעשרה שרוצים להוסיף. |
albumPosition |
חובה. המיקום באלבום שבו רוצים להוסיף את ההעשרה. |
גוף התשובה
פריט ההעשרה שנוצר.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"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 . העשרה להוספה לאלבום. זה יכול להיות טקסט, מיקום או מפה. enrichment יכול להיות רק אחת מהאפשרויות הבאות: |
|
textEnrichment |
הטקסט שיתווסף לאלבום. |
locationEnrichment |
המיקום שיתווספו לאלבום. |
mapEnrichment |
מפה שתצורף לאלבום. |
TextEnrichment
העשרה שמכילה טקסט.
ייצוג JSON |
---|
{ "text": string } |
שדות | |
---|---|
text |
טקסט לפריט העשרה זה. |
LocationEnrichment
העשרה שמכילה מיקום יחיד.
ייצוג ב-JSON |
---|
{
"location": {
object ( |
שדות | |
---|---|
location |
המיקום של פריט העשרה הזה. |
מיקום
מייצג מיקום פיזי.
ייצוג JSON |
---|
{
"locationName": string,
"latlng": {
object ( |
שדות | |
---|---|
locationName |
שם המיקום שיוצג. |
latlng |
המיקום של המיקום במפה. |
LatLng
אובייקט שמייצג צמד קואורדינטות של רוחב וקו אורך. הוא מופיע כצמד של מספרים שלמים (double) שמייצגים מעלות של קו רוחב ומעלות של קו אורך. אלא אם צוין אחרת, האובייקט הזה חייב לעמוד בתקן WGS84. הערכים חייבים להיות בטווחים מנורמלים.
ייצוג JSON |
---|
{ "latitude": number, "longitude": number } |
שדות | |
---|---|
latitude |
קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0]. |
longitude |
קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0]. |
MapEnrichment
העשרה שמכילה מפה, שמציגה את מיקומי המוצא והיעד.
ייצוג JSON |
---|
{ "origin": { object ( |
שדות | |
---|---|
origin |
מיקום המקור של פריט העשרה הזה. |
destination |
מיקום היעד של פריט ההעשרה הזה. |
EnrichmentItem
פריט העשרה.
ייצוג JSON |
---|
{ "id": string } |
שדות | |
---|---|
id |
מזהה של פריט העשרה. |