Method: accounts.locations.list

Belirtilen hesaba ilişkin 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, AccountType KİŞİSEL ise yalnızca doğrudan Hesaba ait olan Konumlar döndürülür. Aksi takdirde, Hesaptan erişilebilen tüm konumları doğrudan veya dolaylı olarak döndürecektir.

Sorgu parametreleri

Parametreler
pageSize

integer

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

pageToken

string

Belirtilirse sonraki page konumu getirir. Sayfa jetonu, istenen sayfa boyutuna sığabilecek daha fazla konum olduğunda önceki locations.list çağrıları tarafından döndürülür.

filter

string

Döndürülecek konumları kısıtlayan 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ğı BCP 47 dil kodu. Bu dil mevcut değilse bunlar konumun dilinde sağlanır. İkisi de yoksa İngilizce olarak sunulur.

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

orderBy

string

İstek için sıralama düzeni. Birden çok alan, SQL söz dizimine uygun şekilde virgülle ayrılmalıdır. Varsayılan sıralama düzeni artan düzendir. Azalan sırayı belirtmek için " azl" eklenmelidir. orderBy için geçerli olan alanlar locationName ve storeCode değerleridir. Örneğin: "locationName, storeCode desc" veya "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:

locations.ListLocations için yanıt iletisi.

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, bir sonraki 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 mevcut değildir.

totalSize

integer

Sayfalara ayırmadan bağımsız olarak listedeki yaklaşık Konum 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.