REST Resource: accounts.locations.media

Kaynak: MediaItem

Tek bir medya öğesi.

JSON gösterimi 
{
  "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.
}
Alanlar
name

string

Bu medya öğesinin kaynak adı. accounts/{accountId}/locations/{locationId}/media/{mediaKey}
mediaFormat

enum (MediaFormat)

Bu medya öğesinin biçimi. Medya öğesi oluşturulduğunda ayarlanmalıdır ve diğer tüm isteklerde salt okunur olur. Güncellenemez.
locationAssociation

object (LocationAssociation)

CreatePhoto aranırken gereklidir. Bu medya öğesinin konumuna nasıl bağlı olduğunu açıklar. Bir kategori (örneğin, EXTERIOR) veya bir fiyat listesi öğesinin kimliği olmalıdır.

media.create içeren bir konuma yeni medya eklerken bu gereklidir. Diğer medya türlerinde (ör. yerel yayınlardaki fotoğraflar) bu özellik gösterilmez.
googleUrl

string

Yalnızca çıkış. Bu medya öğesi için Google tarafından barındırılan URL. Bu URL zaman içinde değişebileceği için statik değildir. Bu, video için yer paylaşımlı oynatma simgesi içeren bir önizleme resmidir.
thumbnailUrl

string

Yalnızca çıkış. Sağlandığında, bu medya öğesinin küçük resminin URL'si.
createTime

string (Timestamp format)

Yalnızca çıkış. Bu medya öğesinin oluşturulma zamanı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
dimensions

object (Dimensions)

Yalnızca çıkış. Piksel cinsinden boyutlar (genişlik ve yükseklik).
insights

object (MediaInsights)

Yalnızca çıkış. Bu medya öğesine ilişkin istatistikler.
attribution

object (Attribution)

Yalnızca çıkış. Müşteri medya öğeleri için ilişkilendirme bilgileri. Bu atfı, kullanıcılarınıza sağlandığı şekilde göstermeniz ve silmemeniz veya değiştirmemeniz gerekir.
description

string

Bu medya öğesinin açıklaması. Açıklamalar Google Benim İşletmem API'si aracılığıyla değiştirilemez ancak kapak fotoğrafı olmayan yeni bir medya öğesi oluşturulurken ayarlanabilir.

data alanı. Medya öğesinin veri kaynağı. Yeni bir medya öğesi oluştururken URL veya veri referansı sağlanmalıdır.

PROFILE ve COVER kategorileri hariç tüm fotoğrafların kısa kenarı en az 250 piksel ve dosya boyutu en az 10.240 bayt olmalıdır.

Yüklenen tüm fotoğraflar, fotoğraflar için İşletme Profili kurallarına uygun olmalıdır. data şunlardan yalnızca biri olabilir:
sourceUrl

string

Medya öğesinin alınabileceği, herkesin erişebileceği URL.

Bunlardan birini oluştururken dataRef, medya öğesinin kaynağını belirtecek şekilde ayarlanmalıdır.

Medya öğesi oluşturulurken sourceUrl kullanıldıysa medya öğesi alındığında bu kaynak URL ile doldurulur.

Bu alan güncellenemiyor.
dataRef

object (MediaItemDataRef)

Yalnızca giriş. media.startUpload yöntemiyle elde edilen medya öğesi ikili verisine referans.

Medya öğesi oluştururken

sourceUrl

veya

dataRef

ayarlanmalıdır.

MediaItemDataRef

Google Benim İşletmem API'si aracılığıyla yüklenen bir MediaItem dosyasının fotoğraflı ikili program verilerine referans.

media.startUpload ile bir veri referansı oluşturun ve [media.upload] dosyasına bayt yüklerken ve ardından media.create çağırırken bu referansı kullanın.

JSON gösterimi 
{
  "resourceName": string
}
Alanlar
resourceName

string

Bu medya öğesinin ikili verileri için benzersiz kimlik. Fotoğraf verilerini [media.upload] ile yüklemek ve media.create ile bu baytlardan yeni bir medya öğesi oluşturmak için kullanılır.

Bayt yükleme örneği: curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resourceName}?uploadType=media"

media.create aramaları için bunu MediaItem dataRef olarak ayarlayın.

MediaFormat

Medya biçimi için numaralandırma.

Sıralamalar
MEDIA_FORMAT_UNSPECIFIED Biçim belirtilmedi.
PHOTO Medya öğesi bir fotoğraf. Bu sürümde yalnızca fotoğraflar desteklenmektedir.
VIDEO Medya öğesi bir video.

LocationAssociation

Medya öğesinin konumuyla nasıl ilişkilendirildiği.

JSON gösterimi 
{

  // 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.
}
Alanlar
location_attachment_type alanı. Konum medyasında, ilişkili oldukları fiyat listesi öğesinin bir kategorisi veya kimliği olmalıdır. Konum harici medyada (örneğin, yerel yayın fotoğrafları) ikisi de olmamalıdır. location_attachment_type şunlardan yalnızca biri olabilir:
category

enum (Category)

Bu konum fotoğrafının ait olduğu kategori.
priceListItemId

string

Bu konum fotoğrafının ilişkili olduğu bir fiyat listesi öğesinin kimliği.

Kategori

Medya öğesi kategorisi için sıralama.

Sıralamalar
CATEGORY_UNSPECIFIED Belirtilmemiş kategori.
COVER Kapak fotoğrafı. Bir konumun yalnızca bir kapak fotoğrafı vardır.
PROFILE Profil fotoğrafı. Bir konumun yalnızca bir profil fotoğrafı vardır.
EXTERIOR Dış medya.
INTERIOR İç medya.
PRODUCT Ürün medyası.
AT_WORK "İş yerindeki" medya.
FOOD_AND_DRINK Yiyecek ve içecek medyası.
MENU Menü medyası.
COMMON_AREA Ortak alan medyası.
ROOMS Oda medyası.
TEAMS Teams medyası.
ADDITIONAL Kategorize edilmemiş ek medya.

Boyutlar

Medya öğesinin boyutları.

JSON gösterimi 
{
  "widthPixels": integer,
  "heightPixels": integer
}
Alanlar
widthPixels

integer

Medya öğesinin piksel cinsinden genişliği.
heightPixels

integer

Medya öğesinin piksel cinsinden yüksekliği.

MediaInsights

Medya öğesiyle ilgili analizler ve istatistikler.

JSON gösterimi 
{
  "viewCount": string
}
Alanlar
viewCount

string (int64 format)

Yalnızca çıkış. Medya öğesinin görüntülenme sayısı.

İlişkilendirme

Müşteri medya öğeleri için atıf bilgileri (ör. katkıda bulunanın adı ve profil resmi).

JSON gösterimi 
{
  "profileName": string,
  "profilePhotoUrl": string,
  "takedownUrl": string,
  "profileUrl": string
}
Alanlar
profileName

string

Medya öğesiyle ilişkilendirilecek kullanıcı adı.
profilePhotoUrl

string

İlişkili kullanıcının profil fotoğrafı küçük resminin URL'si.
takedownUrl

string

Medya öğesinin uygunsuz olması durumunda bildirilebileceği yayından kaldırma sayfasının URL'si.
profileUrl

string

İlişkilendirilen kullanıcının Google Haritalar profil sayfasının URL'si.

Yöntemler

create

 Konum için yeni bir medya öğesi oluşturur.

delete

 Belirtilen medya öğesini siler.

get

 İstenen medya öğesi için meta verileri döndürür.

list

 Bir konumla ilişkili medya öğelerinin listesini döndürür.

patch

 Belirtilen medya öğesinin meta verilerini günceller.

startUpload

 Medya öğesi yükleme için bir MediaItemDataRef oluşturur.