Method: properties.audienceLists.create

Daha sonra erişmek üzere bir kitle listesi oluşturur. Bu yöntem, kitle listesinin kaynak adını hızlı bir şekilde döndürür ve bir kitle listesi oluşturmak için uzun süreli eşzamansız bir istek başlatır. Bir kitle listesindeki kullanıcıları listelemek için öncelikle bu yöntemle kitle listesini oluşturun, ardından kitle kaynağı adını audienceLists.query yöntemine gönderin.

Örneklerle Kitle Listeleri'ne giriş için Kitle Listesi Oluşturma bölümüne bakın.

Kitle listesi, kitle listesi oluşturulurken o anda kitlede bulunan kullanıcıların anlık görüntüsüdür. Bir kitle için farklı günlerde kitle listeleri oluşturmak, kullanıcılar kitleye girip çıktıkça farklı sonuçlar döndürür.

Google Analytics 4'teki kitleler, kullanıcılarınızı işletmeniz için önem taşıyan ölçütlere göre segmentlere ayırmanızı sağlar. Daha fazla bilgi için https://support.google.com/analytics/answer/9267572 adresine bakın. Kitle listeleri, her bir kitledeki kullanıcıları içerir.

Bu yöntem, beta sürüme geçmeden önce söz dizimi ve özelliklerle ilgili geri bildirim toplamak amacıyla alfa kararlılığında kullanıma sunulmuştur. Bu API hakkında geri bildirimde bulunmak için Google Analytics Audience Export API Geri Bildirimi formunu doldurun.

HTTP isteği

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

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

Yol parametreleri

Parametreler
parent

string

Zorunlu. Bu kitle listesinin oluşturulacağı üst kaynak. Biçim: properties/{property}

İstek içeriği

İstek metni, AudienceList öğesinin bir örneğini içerir.

Yanıt gövdesi

Bu kaynak, bir ağ API çağrısının sonucu olan uzun süreli bir işlemi temsil eder.

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

JSON gösterimi 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
Alanlar
name

string

Sunucu tarafından atanan ad. Bu ad, yalnızca onu ilk döndüren hizmette benzersizdir. Varsayılan HTTP eşlemesini kullanıyorsanız name, operations/{unique_id} ile biten bir kaynak adı olmalıdır.
metadata

object

İşlemle ilişkilendirilen hizmete özgü meta veriler. Rapor genellikle ilerleme bilgilerini ve oluşturma zamanı gibi ortak meta verileri içerir. Bazı hizmetler bu tür meta verileri sağlamayabilir. Uzun süreli bir işlem döndüren yöntemler, varsa meta veri türünü belgelemelidir.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.
done

boolean

Değer false ise işlem devam ediyor demektir. true ise işlem tamamlanmıştır ve error veya response kullanılabilir.
Birlik alanı result. İşlem sonucu. Bu değer, error veya geçerli bir response olabilir. done == false ise ne error ne de response ayarlanır. done == true ise tam olarak error veya response değerlerinden biri ayarlanabilir. Bazı hizmetler sonucu sağlamayabilir. result şunlardan yalnızca biri olabilir:
error

object (Status)

Hata veya iptal durumunda işlemin hata sonucu.
response

object

İşlemin normal, başarılı yanıtı. Orijinal yöntem başarıyla ilgili veri döndürmezse (ör. Delete) yanıt google.protobuf.Empty olur. Orijinal yöntem standart Get/Create/Update ise yanıt kaynak olmalıdır. Diğer yöntemler için yanıtın türü XxxResponse olmalıdır. Burada Xxx, orijinal yöntemin adıdır. Örneğin, orijinal yöntemin adı TakeSnapshot() ise tahmin edilen yanıt türü TakeSnapshotResponse olur.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

Durum

Status türü, REST API'leri ve RPC API'leri dahil olmak üzere farklı programlama ortamları için uygun olan bir mantıksal hata modeli tanımlar. gRPC tarafından kullanılır. Her Status mesajı üç veri parçası içerir: hata kodu, hata mesajı ve hata ayrıntıları.

API Tasarım Kılavuzu'nda bu hata modeli ve bu modelle nasıl çalışılacağı hakkında daha fazla bilgi edinebilirsiniz.

JSON gösterimi 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Alanlar
code

integer

google.rpc.Code öğesinin enum değeri olması gereken durum kodu.
message

string

Geliştiricilere yönelik bir hata mesajı. Bu mesaj İngilizce olmalıdır. Kullanıcılara yönelik tüm hata mesajları yerelleştirilmeli ve google.rpc.Status.details alanında gönderilmelidir veya istemci tarafından yerelleştirilmelidir.
details[]

object

Hata ayrıntılarını içeren mesajların listesi. API'lerin kullanabileceği bir dizi yaygın mesaj türü vardır.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.