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 öğesi için 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 konumuyla nasıl bağlantılı olduğunu açıklar. Ya bir kategori (örneğin, DIŞARIYA) ya da bir fiyat listesi öğesinin kimliği olmalıdır.

Bu, media.create ile bir konuma yeni medya eklerken gereklidir. Diğer medya türlerinde (ör. yerel yayınlardaki fotoğraflar) bu özellik bulunmaz.
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 sabit değildir. Video için bu, yer paylaşımlı oynatma simgesine sahip bir önizleme resmi olacaktır.
thumbnailUrl

string

Yalnızca çıkış. Sağlandığında, bu medya öğesi için bir küçük resmin URL'si.
createTime

string (Timestamp format)

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

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 öğesinin istatistikleri.
attribution

object (Attribution)

Yalnızca çıkış. Müşteri medya öğeleri için ilişkilendirme bilgileri. Bu atıfı kullanıcılarınıza sağlandığı şekilde göstermeli ve atfı silmemeli veya değiştirmemelisiniz.
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ştururken ayarlanabilir.

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

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

Yüklenen tüm fotoğraflar, fotoğraflarla ilgili İş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 bir URL.

Bunlardan birini oluştururken veya dataRef'in, medya öğesinin kaynağını belirtmek için ayarlanması gerekir.

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

Bu alan güncellenemez.
dataRef

object (MediaItemDataRef)

Yalnızca giriş. media.startUpload yöntemi ile elde edilen medya öğesi ikili verilerine referans.

Medya öğesi oluştururken:

sourceUrl

veya

dataRef

ayarlanmalıdır.

MediaItemDataRef

Google Benim İşletmem API'si üzerinden yüklenen bir MediaItem veri ikilisi verilerine referans

media.startUpload kullanarak bir veri referansı oluşturun ve baytları [media.upload] dosyasına yükleyip ardından media.create çağrısında bulunurken bu referansı kullanın.

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

string

Bu medya öğesinin ikili verilerinin benzersiz kimliği. 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 çağrıları için bunu MediaItem dataRef olarak ayarlayın.

MediaFormat

Medya biçimi için sıralama.

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

LocationAssociation

Medya öğesinin konumuyla ilişkilendirilme şekli.

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
Birleştirme alanı location_attachment_type. Konum medyasının bir kategorisi veya ilişkilendirildiği fiyat listesi öğesinin kimliği olmalıdır. Konum dışı medyalar (örneğin, yerel yayın fotoğrafları) bunların 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şkilendirildiği fiyat listesi öğesinin kimliği.

Kategori

Medya öğesi kategorisinin sıralaması.

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 "İş yerinde" medya
FOOD_AND_DRINK Yiyecek ve içecek medyası.
MENU Menü medyası.
COMMON_AREA Ortak alan medyası.
ROOMS Oda medyası.
TEAMS Medya ekipleri.
ADDITIONAL Ek, kategorize edilmemiş 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

Katkıda bulunanın adı ve profil resmi gibi müşteri medya öğelerine ilişkin ilişkilendirme bilgileri.

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

string

Medya öğesinin ilişkilendirileceği kullanıcı adı.
profilePhotoUrl

string

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

string

Uygunsuz olması halinde medya öğesinin 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üklemek için bir MediaItemDataRef oluşturur.