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
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata

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

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