Method: audienceMembers.ingest

Sağlanan Destination'ye AudienceMember kaynak listesini 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 metni

İstek içeriği 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ı. İstekteki tüm kullanıcılar için geçerli olacak istek düzeyinde izin. 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ı. 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ı. UserData yüklemeleri için sağlanmalıdır. 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ı. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen kişisel verilerin karma oluşturma işlemi 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ı. Kullanıcının kabul ettiği/reddettiği hizmet şartları.

Yanıt metni

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,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
Alanlar
requestId

string

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

fieldWarnings[]

object (FieldWarning)

Alan yollarıyla ilgili ayrıntılı satır düzeyinde uyarılar.

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ı. Müşteri Eşleştirme Hizmet Şartları: https://support.google.com/adspolicy/answer/6299717. Bu, UserData veya MobileData öğesi alındığında kabul edilmelidir. Bu alan, İş Ortağı Eşleştirme kullanıcı listesi için zorunlu değildir.

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.