Method: audienceMembers.ingest

Belirtilen Destination konumuna AudienceMember kaynak listesi yükler.

HTTP isteği

POST https://datamanager.googleapis.com/v1/audienceMembers:ingest

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

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Alanlar
destinations[]

object (Destination)

Zorunlu. Kitle üyelerinin gönderileceği hedeflerin listesi.

audienceMembers[]

object (AudienceMember)

Zorunlu. Belirtilen hedeflere gönderilecek kullanıcıların listesi. Tek bir istekte en fazla 10.000 AudienceMember kaynağı gönderilebilir.

consent

object (Consent)

İsteğe bağlıdır. İstek düzeyinde izin, isteğin tüm kullanıcıları için geçerli olur. Kullanıcı düzeyinde izin, istek düzeyinde izni geçersiz kılar ve her AudienceMember içinde belirtilebilir.

validateOnly

boolean

İsteğe bağlıdır. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

encoding

enum (Encoding)

İsteğe bağlıdır. UserData yüklemeleri için gereklidir. Kullanıcı tanımlayıcılarının kodlama türü. Karma oluşturulmuş kullanıcı tanımlayıcıları için bu, karma oluşturulmuş dizenin kodlama türüdür. Şifrelenmiş karma kullanıcı tanımlayıcıları için bu, içteki karma dizeyi değil, dıştaki şifrelenmiş dizenin kodlama türüdür. Bu nedenle, içteki karma dize, dıştaki şifrelenmiş dizeden farklı şekilde kodlanabilir. UserData dışındaki yüklemeler için bu alan yoksayılır.

encryptionInfo

object (EncryptionInfo)

İsteğe bağlıdır. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için bu alan yoksayılır.

termsOfService

object (TermsOfService)

İsteğe bağlıdır. Kullanıcının kabul ettiği/reddettiği hizmet şartları.

Yanıt gövdesi

IngestAudienceMembersRequest tarafından verilen yanıt.

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

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

string

İsteğin otomatik olarak oluşturulan kimliği.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager

TermsOfService

Kullanıcının kabul ettiği/reddettiği hizmet şartları.

JSON gösterimi
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Alanlar
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

İsteğe bağlıdır. Müşteri Eşleştirme Hizmet Şartları: https://support.google.com/adspolicy/answer/6299717. Bu, Müşteri Eşleştirme kullanıcı listelerine yapılan tüm yüklemeler için kabul edilmelidir.

TermsOfServiceStatus

Arayanın hizmet şartlarını kabul etme veya reddetme kararını gösterir.

Sıralamalar
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Belirtilmedi.
ACCEPTED Arayanın hizmet şartlarını kabul etmeyi seçtiğini gösteren durum.
REJECTED Arayanın hizmet şartlarını reddettiğini gösteren durum.