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 "Zulu"، بدقّة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "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 بايت على الأقل.

يجب أن تتوافق جميع الصور التي يتم تحميلها مع إرشادات الصور في "الملف التجاري على Google". يمكن أن يكون التعليق data إحدى القيم التالية فقط:
sourceUrl

string

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

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

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

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

object (MediaItemDataRef)

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

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

sourceUrl

أو

dataRef

يجب ضبطها.

MediaItemDataRef

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

أنشئ مرجع بيانات باستخدام 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، اضبط هذا الخيار على MediaItem dataRef.

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 وسائط 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 لتحميل عناصر الوسائط.