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şturulurken ayarlanmalıdır ve diğer tüm isteklerde salt okunurdur. Güncellenemez.
locationAssociation

object (LocationAssociation)

CreatePhoto aranırken gereklidir. Bu medya öğesinin konumuyla nasıl bağlantılı olduğunu açıklar. Kategori (ör. EXTERIOR) veya fiyat listesi öğesinin kimliği olmalıdır.

media.create içeren bir konuma yeni medya eklerken bu işlem gereklidir. Diğer medya türlerinde (ör. yerel gönderilerdeki fotoğraflar) bu özellik bulunmaz.
googleUrl

string

Yalnızca çıkış. Bu medya öğesinin Google tarafından barındırılan URL'si. Bu URL, zaman içinde değişebileceği için statik değildir. Videolar için bu, oynatma simgesi yerleştirilmiş bir önizleme resmi olacaktır.
thumbnailUrl

string

Yalnızca çıkış. Sağlandığı durumlarda, bu medya öğesinin küçük resim görüntüsünün URL'si.
createTime

string (Timestamp format)

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

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip). Ö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 ilişkilendirmeyi kullanıcılarınıza sağlandığı şekilde göstermeli, 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şturulurken ayarlanabilir.

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

PROFILE ve COVER kategorisi hariç 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 aşağıdakilerden yalnızca biri olabilir:
sourceUrl

string

Medya öğesinin alınabileceği herkese açık bir URL.

Bu öğelerden biri oluşturulurken medya öğesinin kaynağını belirtmek için dataRef ayarlanmalıdır.

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

Bu alan güncellenemez.
dataRef

object (MediaItemDataRef)

Yalnızca giriş. media.startUpload yöntemiyle elde edilen medya öğesi ikili verilerine yapılan bir referans.

Medya öğesi oluştururken şunlardan birini yapın:

sourceUrl

veya

dataRef

ayarlanmalıdır.

MediaItemDataRef

Google Benim İşletmem API'si aracılığıyla yüklenen bir MediaItem öğesinin fotoğraf ikili verilerine referans.

media.startUpload kullanarak bir veri referansı oluşturun ve baytları [media.upload] konumuna 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 verilerinin benzersiz kimliği. [media.upload] ile fotoğraf verilerini 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 Enum.

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

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 birleşik alanı. Konum medyası, bir kategoriye veya ilişkilendirildiği bir fiyat listesi öğesinin kimliğine sahip olmalıdır. Konumla ilgili olmayan medyada (ör. yerel gönderi fotoğrafları) bu bilgilerden hiçbiri bulunmamalıdır. location_attachment_type aşağıdakilerden 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 kategorisi için enum.

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 İçerideki medya.
PRODUCT Ürün medyası.
AT_WORK "İş yerinde" medya
FOOD_AND_DRINK Yiyecek ve içecek medyaları
MENU Menü medyası.
COMMON_AREA Ortak alan medyası.
ROOMS Odalar medyası.
TEAMS Teams medyası.
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

Müşteri medya öğeleriyle ilgili ilişkilendirme 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 öğ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

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ı URL'si.

Yöntemler

create

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

delete

 Belirtilen medya öğesini siler.

get

 İstenen medya öğesinin meta verilerini 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 MediaItemDataRef oluşturur.