Method: customers.uploadUserData

Przesyła podane dane użytkownika.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, którego dane użytkownika mają zostać zaktualizowane.

Treść żądania

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

Zapis JSON 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
Pola
operations[]

object (UserDataOperation)

To pole jest wymagane. Lista operacji do wykonania.
Pole sumy metadata. Metadane żądania. metadata może mieć tylko jedną z tych wartości:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Metadane aktualizacji danych na liście użytkowników z kierowania na listę klientów.

Treść odpowiedzi

Odpowiedź na pytanie (UserDataService.UploadUserData) przesłane za pomocą tej usługi nie będzie widoczna w sekcji „Członkowie segmentu” na liście kierowania na listę klientów w interfejsie Google Ads.

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

Zapis JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Pola
uploadDateTime

string

Data i godzina odebrania żądania przez interfejs API, w formacie „rrrr-mm-dd gg:mm:ss+|-gg:mm”, na przykład „2019-01-01 12:32:45-08:00”.
receivedOperationsCount

integer

Liczba operacji przesyłania danych odebranych przez interfejs API.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

UserDataOperation

Operacja, która ma zostać wykonana na żądanie UploadUserDataRequest.

Zapis JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
Pola
Pole sumy operation. Operacja, która ma zostać wykonana na żądanie UploadUserDataRequest. operation może mieć tylko jedną z tych wartości:
create

object (UserData)

Lista danych użytkownika, które mają zostać dołączone do listy użytkowników.
remove

object (UserData)

Lista danych użytkownika, które zostaną usunięte z listy użytkowników.