Method: albums.addEnrichment

غنی سازی را در یک موقعیت مشخص در یک آلبوم تعریف شده اضافه می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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

NewEnrichment Item

یک مورد غنی‌سازی جدید برای افزودن به آلبوم، که توسط 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 )

نقشه به آلبوم اضافه شود.

غنی سازی متن

غنی سازی حاوی متن

نمایندگی JSON
{
  "text": string
}
زمینه های
text

string

متن برای این آیتم غنی‌سازی.

غنی سازی مکان

غنی سازی حاوی یک مکان واحد.

نمایندگی 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] باشد.

Map Enrichment

غنی‌سازی حاوی نقشه، نشان‌دهنده مکان‌های مبدا و مقصد.

نمایندگی JSON
{
  "origin": {
    object (Location)
  },
  "destination": {
    object (Location)
  }
}
زمینه های
origin

object ( Location )

محل مبدا برای این مورد غنی سازی.

destination

object ( Location )

مکان مقصد برای این آیتم غنی شده.

آیتم غنی سازی

یک مورد غنی سازی

نمایندگی JSON
{
  "id": string
}
زمینه های
id

string

شناسه کالای غنی شده