Method: audienceMembers.ingest

Przesyła listę zasobów AudienceMember do podanego Destination.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

object (Destination)

Wymagane. Lista miejsc docelowych, do których mają zostać wysłani członkowie grupy odbiorców.
audienceMembers[]

object (AudienceMember)

Wymagane. Lista użytkowników, którzy mają zostać wysłani do określonych miejsc docelowych. W jednym żądaniu można wysłać maksymalnie 10 tys. zasobów AudienceMember.
consent

object (Consent)

Opcjonalnie. Zgoda na poziomie żądania, która ma być stosowana do wszystkich użytkowników w żądaniu. Zgoda na poziomie użytkownika zastępuje zgodę na poziomie żądania i można ją określić w każdym elemencie AudienceMember.
validateOnly

boolean

Opcjonalnie. Do celów testowych. Jeśli wartość to true, żądanie jest weryfikowane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.
encoding

enum (Encoding)

Opcjonalnie. Musisz podać tę wartość w przypadku przesyłania UserData. Typ kodowania identyfikatorów użytkowników. W przypadku identyfikatorów użytkowników z haszowaniem jest to typ kodowania ciągu z haszem. W przypadku zaszyfrowanych identyfikatorów użytkowników z haszowaniem jest to typ kodowania zewnętrznego zaszyfrowanego ciągu, ale niekoniecznie wewnętrznego ciągu z haszem. Oznacza to, że wewnętrzny ciąg z haszem może być kodowany w inny sposób niż zewnętrzny ciąg zaszyfrowany. W przypadku przesyłania danych innych niż UserData to pole jest ignorowane.
encryptionInfo

object (EncryptionInfo)

Opcjonalnie. Informacje o szyfrowaniu w przypadku przesyłania UserData. Jeśli nie jest ustawiona, przyjmuje się, że przesłane informacje umożliwiające identyfikację są haszowane, ale nie szyfrowane. W przypadku przesyłania danych innych niż UserData to pole jest ignorowane.
termsOfService

object (TermsOfService)

Opcjonalnie. Warunki korzystania z usługi, które użytkownik zaakceptował lub odrzucił.

Treść odpowiedzi

Odpowiedź na IngestAudienceMembersRequest.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
Pola
requestId

string

Automatycznie wygenerowany identyfikator żądania.
fieldWarnings[]

object (FieldWarning)

Szczegółowe ostrzeżenia na poziomie wiersza ze ścieżkami pól.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

TermsOfService

Warunki korzystania z usługi, które użytkownik zaakceptował lub odrzucił.

Zapis JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Pola
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

Opcjonalnie. Warunki korzystania z usługi kierowanie na listę klientów: https://support.google.com/adspolicy/answer/6299717. Musisz je zaakceptować, gdy przesyłasz UserData lub MobileData. To pole nie jest wymagane w przypadku listy użytkowników Dopasowania partnerów.

TermsOfServiceStatus

Określa decyzję dzwoniącego o zaakceptowaniu lub odrzuceniu warunków korzystania z usługi.

Wartości w polu enum
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Nieokreślone.
ACCEPTED Stan wskazujący, że dzwoniący zaakceptował warunki korzystania z usługi.
REJECTED Stan wskazujący, że dzwoniący odrzucił warunki korzystania z usługi.