REST Resource: accounts.locations.media

المرجع: MediaItem

عنصر وسائط واحد

تمثيل JSON 
{
  "name": string,
  "mediaFormat": enum (MediaFormat),
  "locationAssociation": {
    object (LocationAssociation)
  },
  "googleUrl": string,
  "thumbnailUrl": string,
  "createTime": string,
  "dimensions": {
    object (Dimensions)
  },
  "insights": {
    object (MediaInsights)
  },
  "attribution": {
    object (Attribution)
  },
  "description": string,

  // Union field data can be only one of the following:
  "sourceUrl": string,
  "dataRef": {
    object (MediaItemDataRef)
  }
  // End of list of possible types for union field data.
}
الحقول
name

string

اسم المورد لعنصر الوسائط هذا. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

تنسيق عنصر الوسائط هذا. يجب تحديد هذا الإعداد عند إنشاء عنصر الوسائط، كما يجب أن يكون متاحًا للقراءة فقط في جميع الطلبات الأخرى. يتعذّر التعديل.
locationAssociation

object (LocationAssociation)

مطلوب عند الاتصال بالرقم CreatePhoto. لوصف كيفية ربط عنصر الوسائط هذا بموقعه يجب أن يكون إما فئة (مثلاً، EXTERIOR) أو معرّف عنصر قائمة أسعار.

هذا الإجراء مطلوب عند إضافة وسائط جديدة إلى موقع باستخدام "media.create". بالنسبة إلى الأنواع الأخرى من الوسائط، مثل الصور في المشاركات المحلية، لن تكون هذه السمة متوفّرة.
googleUrl

string

النتائج فقط. عنوان URL الذي تستضيفه Google لعنصر الوسائط هذا. عنوان URL هذا غير ثابت لأنّه قد يتغيّر بمرور الوقت. بالنسبة إلى الفيديو، ستكون هذه صورة معاينة مع رمز تشغيل متراكب.
thumbnailUrl

string

النتائج فقط. تمثّل هذه السمة عنوان URL لصورة مصغّرة لعنصر الوسائط هذا، في حال توفّره.
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء عنصر الوسائط هذا

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

النتائج فقط. الأبعاد (العرض والارتفاع) بالبكسل.
insights

object (MediaInsights)

النتائج فقط. إحصاءات لملف الوسائط هذا.
attribution

object (Attribution)

النتائج فقط. معلومات تحديد المصدر الخاصة بعناصر الوسائط الخاصة بالعملاء ويجب عرض هذه الإحالة كما تم تقديمها للمستخدمين، ويجب عدم حذف الإحالة أو تغييرها.
description

string

وصف لعنصر الوسائط هذا. لا يمكن تعديل الأوصاف من خلال واجهة برمجة تطبيقات "نشاطي التجاري على Google"، ولكن يمكن ضبطها عند إنشاء عنصر وسائط جديد ليس صورة غلاف.

حقل الاتحاد data. مصدر بيانات ملف الوسائط عند إنشاء عنصر وسائط جديد، يجب تقديم عنوان URL أو مرجع بيانات.

باستثناء الفئتين PROFILE وCOVER، يجب ألا يقل حجم جميع الصور عن 250 بكسل على الحافة القصيرة، وألا يقلّ حجم الملف عن 10240 بايت.

ويجب أن تتّبع كل الصور المحمَّلة إرشادات الملف التجاري للصور. يمكن أن يكون data واحدًا فقط مما يلي:
sourceUrl

string

عنوان URL متاح للجميع ويمكن استرداد ملف الوسائط منه

عند إنشاء أحد هذه القيم، يجب تعيين dataref لتحديد مصدر عنصر الوسائط.

في حال استخدام sourceUrl عند إنشاء ملف وسائط، ستتم تعبئته بعنوان URL المصدر هذا عند استرداد ملف الوسائط.

لا يمكن تعديل هذا الحقل.
dataRef

object (MediaItemDataRef)

الإدخال فقط. مرجع إلى البيانات الثنائية لعنصر الوسائط كما تم الحصول عليه من خلال طريقة media.startUpload.

وعند إنشاء عنصر وسائط،

sourceUrl

أو

dataRef

.

MediaItemDataRef

الإشارة إلى البيانات الثنائية لصور MediaItem تم تحميله من خلال Google My Business API

يمكنك إنشاء مرجع بيانات باستخدام media.startUpload، واستخدام هذه المرجع عند تحميل وحدات البايت إلى [media.upload] ثم طلب media.create بعد ذلك.

تمثيل JSON 
{
  "resourceName": string
}
الحقول
resourceName

string

المعرّف الفريد للبيانات الثنائية لعنصر الوسائط هذا. يُستخدَم هذا الحقل لتحميل بيانات الصورة باستخدام [media.upload] وعند إنشاء ملف وسائط جديد من وحدات البايت هذه باستخدام media.create.

مثال على وحدات البايت للتحميل: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

بالنسبة إلى مكالمات media.create، يجب ضبط هذا الإعداد على dataRef MediaItem.

MediaFormat

رقم تعداد لتنسيق الوسائط

عمليات التعداد
MEDIA_FORMAT_UNSPECIFIED لم يتم تحديد التنسيق.
PHOTO عنصر الوسائط هو صورة. في هذا الإصدار، يتم دعم الصور فقط.
VIDEO يكون عنصر الوسائط فيديو.

LocationAssociation

كيفية ارتباط عنصر الوسائط بموقعه

تمثيل JSON 
{

  // Union field location_attachment_type can be only one of the following:
  "category": enum (Category),
  "priceListItemId": string
  // End of list of possible types for union field location_attachment_type.
}
الحقول
حقل الاتحاد location_attachment_type. يجب أن تحتوي وسائط الموقع الجغرافي على فئة أو رقم تعريف لعنصر قائمة الأسعار المرتبط به. ويجب ألا تحتوي الوسائط التي لا تتعلق بالموقع (مثل صور المشاركات المحلية) على أي منهما. يمكن أن يكون location_attachment_type واحدًا فقط مما يلي:
category

enum (Category)

الفئة التي تنتمي إليها صورة الموقع هذه.
priceListItemId

string

معرّف عنصر قائمة الأسعار المرتبط بصورة الموقع الجغرافي هذه.

الفئة

تعداد لفئة عنصر الوسائط

عمليات التعداد
CATEGORY_UNSPECIFIED فئة غير محدّدة.
COVER صورة الغلاف. يكون للموقع الجغرافي صورة غلاف واحدة فقط.
PROFILE صورة الملف الشخصي يكون للموقع الجغرافي صورة ملف شخصي واحدة فقط.
EXTERIOR الوسائط الخارجية
INTERIOR الوسائط الداخلية
PRODUCT وسائط المنتج
AT_WORK "أثناء العمل" الوسائط.
FOOD_AND_DRINK وسائط حول المأكولات والمشروبات
MENU وسائط القائمة.
COMMON_AREA وسائط المنطقة المشتركة.
ROOMS وسائط الغرف
TEAMS الوسائط للفِرق
ADDITIONAL وسائط إضافية بلا فئة.

الأبعاد

أبعاد ملف الوسائط

تمثيل JSON 
{
  "widthPixels": integer,
  "heightPixels": integer
}
الحقول
widthPixels

integer

عرض عنصر الوسائط بالبكسل
heightPixels

integer

ارتفاع عنصر الوسائط بالبكسل

MediaInsights

إحصاءات وإحصاءات عنصر الوسائط

تمثيل JSON 
{
  "viewCount": string
}
الحقول
viewCount

string (int64 format)

النتائج فقط. عدد مرات مشاهدة عنصر الوسائط.

تحديد المصدر

معلومات عن مصدر الوسائط الخاصة بالعملاء، مثل اسم المساهم وصورة الملف الشخصي

تمثيل JSON 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
الحقول
profileName

string

اسم المستخدم الذي سيتم تحديد مصدر عنصر الوسائط إليه
profilePhotoUrl

string

عنوان URL للصورة المصغّرة لصورة الملف الشخصي للمستخدم منسوبة إليه
takedownUrl

string

عنوان URL لصفحة الإزالة، حيث يمكن الإبلاغ عن عنصر الوسائط إذا كان غير ملائم.
profileUrl

string

عنوان URL لصفحة الملف الشخصي للمستخدم على "خرائط Google"

الطُرق

create

 ينشئ عنصر وسائط جديدًا للموقع.

delete

 يؤدي هذا الإجراء إلى حذف ملف الوسائط المحدّد.

get

 لعرض البيانات الوصفية لعنصر الوسائط المطلوب.

list

 عرض قائمة بعناصر الوسائط المرتبطة بموقع جغرافي

patch

 لتعديل البيانات الوصفية لملف الوسائط المحدّد.

startUpload

 تنشئ هذه السمة MediaItemDataRef لتحميل ملف الوسائط.