Method: accounts.locations.list

Belirtilen hesap için konumları listeler.

HTTP isteği

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Konumların alınacağı hesabın adı. Account değeri AccountType KİŞİSEL ise yalnızca Hesap'ın doğrudan sahibi olduğu Konumlar döndürülür. Aksi takdirde, doğrudan veya dolaylı olarak Hesap'taki erişilebilir tüm konumları döndürür.

Sorgu parametreleri

Parametreler
pageSize

integer

Sayfa başına getirilecek konum sayısı. Varsayılan değer 100, minimum sayfa boyutu 1 ve maksimum sayfa boyutu 100'dür.
pageToken

string

Belirtilmişse konumların sonraki page tanesini getirir. Sayfa jetonu, istenen sayfa boyutuna sığabilecek daha fazla konum olduğunda locations.list için yapılan önceki çağrılar tarafından döndürülür.
filter

string

Döndürülecek konumları sınırlayan bir filtre. Yanıt yalnızca filtreyle eşleşen girişleri içerir. filter boşsa kısıtlamalar uygulanır ve istenen hesap için tüm konumlar (sayfalara ayrılmış) alınır.

Geçerli alanlar ve örnek kullanım hakkında daha fazla bilgi için Konum Verileriyle Çalışma Kılavuzu'na bakın.
languageCode
(deprecated)

string

Görüntüleme konumu özelliklerinin alınacağı dilin BCP 47 kodu. Bu dil mevcut değilse veriler konumun dilinde sunulur. İkisi de yoksa İngilizce olarak sunulur.

Kullanımdan kaldırıldı. 15 Ağustos 2020'den sonra bu alan artık uygulanmayacaktır. Bunun yerine, her zaman konumun dili kullanılır.
orderBy

string

İsteğin sıralama düzeni. Birden fazla alan, SQL söz dizimine uygun şekilde virgülle ayrılmalıdır. Varsayılan sıralama düzeni artan düzendedir. Azalan sırayı belirtmek için " azalan" son eki eklenmelidir. orderBy için geçerli olan alanlar locationName ve storeCode'dur. Örneğin: "locationName, storeCode desc", "locationName" veya "storeCode desc"

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Location.ListLocations için yanıt mesajı.

JSON gösterimi 
{
  "locations": [
    {
      object (Location)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Alanlar
locations[]

object (Location)

Konumlar.
nextPageToken

string

Konum sayısı istenen sayfa boyutunu aşıyorsa bu alan, sonraki bir locations.list çağrısında konumların sonraki sayfasını getirmek için bir jetonla doldurulur. Başka konum yoksa bu alan yanıtta bulunmaz.
totalSize

integer

Sayfalara ayırmadan bağımsız olarak listedeki Konumların yaklaşık sayısı.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.