REST Resource: accounts.locations.media.customers

المرجع: 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

.

الطُرق

get

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

list

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