Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Ta strona została przetłumaczona przez Cloud Translation API.

CustomAudience

Zapis JSON
CustomAudienceStatus
CustomAudienceType
CustomAudienceMember
- Zapis JSON
CustomAudienceMemberType

niestandardowa grupa odbiorców. To lista użytkowników według zainteresowań.

Zapis JSON

Zapis JSON
{ "resourceName": string, "id": string, "status": enum (`CustomAudienceStatus`), "name": string, "type": enum (`CustomAudienceType`), "description": string, "members": [ { object (`CustomAudienceMember`) } ] }

{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}

Pola
`resourceName`	`string` Niezmienna. Nazwa zasobu listy niestandardowej odbiorców. Nazwy zasobów list odbiorców niestandardowych mają postać: `customers/{customerId}/customAudiences/{custom_audience_id}`
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator listy niestandardowej.
`status`	`enum (CustomAudienceStatus)` Tylko dane wyjściowe. Stan tej listy odbiorców. Wskazuje, czy lista niestandardowa jest włączona czy usunięta.
`name`	`string` Nazwa listy niestandardowych odbiorców. Powinien być niepowtarzalny w przypadku wszystkich niestandardowych list odbiorców utworzonych przez klienta. To pole jest wymagane do tworzenia operacji.
`type`	`enum (CustomAudienceType)` Typ listy odbiorców niestandardowych. (w przypadku nowo utworzonych niestandardowych list odbiorców nie można używać parametru „INTEREST” ani „PURCHASE_INTENT”, ale można używać ich w przypadku dotychczasowych list odbiorców)
`description`	`string` Opis tej listy niestandardowych odbiorców.
`members[]`	`object (CustomAudienceMember)` Lista użytkowników, z których składa się ta niestandardowa lista odbiorców. Członków można dodawać podczas tworzenia listy niestandardowych odbiorców. Jeśli członkowie są prezentowani w operacji UPDATE, dotychczasowi członkowie zostaną zastąpieni.

CustomAudienceStatus

Typ enumeracji zawierający możliwe stany niestandardowych list odbiorców.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
`ENABLED`	Stan włączony – niestandardowa lista odbiorców jest włączona i można na nią kierować reklamy.
`REMOVED`	Stan „Usunięty” – lista niestandardowych odbiorców została usunięta i nie można jej używać do kierowania reklam.

CustomAudienceType

Wyliczenie zawierające możliwe typy niestandardowych list odbiorców.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
`AUTO`	Google Ads automatycznie wybierze najlepszą interpretację w momencie wyświetlania reklamy.
`INTEREST`	Dopasowuje użytkowników na podstawie ich zainteresowań.
`PURCHASE_INTENT`	Dopasowuje użytkowników na podstawie tematów, których szukają lub produktów, które rozważają do kupienia.
`SEARCH`	Dopasowuje użytkowników na podstawie tego, czego szukali w Wyszukiwarce Google.

CustomAudienceMember

Członek niestandardowej listy odbiorców. Element członkowski może być SŁOWO_KLUCZOWE, ADRES_URL, CATEGORY_PLACE lub APLIKACJA. Można go tylko utworzyć lub usunąć, ale nie zmienić.

Zapis JSON

Zapis JSON
{ "memberType": enum (`CustomAudienceMemberType`), // Union field `value` can be only one of the following: "keyword": string, "url": string, "placeCategory": string, "app": string // End of list of possible types for union field `value`. }

{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}

Pola
`memberType`	`enum (CustomAudienceMemberType)` Typ elementu na liście odbiorców niestandardowych: KEYWORD, URL, PLACE_CATEGORY lub APP.
Pole unii `value`. Wartość CustomAudienceMember. W zależności od typu elementu wypełniane jest jedno pole. `value` może być tylko jednym z tych elementów:
`keyword`	`string` słowo kluczowe lub wyrażenie słow kluczowych – maksymalnie 10 słów i 80 znaków; W przypadku języków ze znakami dwubajtowymi, np. chińskiego, japońskiego i koreańskiego, dozwolona jest liczba 40 znaków, która opisuje zainteresowania lub działania użytkownika.
`url`	`string` Adres URL HTTP z protokołem (maksymalnie 2048 znaków), który zawiera treści, które interesują użytkowników.
`placeCategory`	`string (int64 format)` Typ miejsca opisany przez kategorię miejsc odwiedzanych przez użytkowników.
`app`	`string` Nazwa pakietu aplikacji na Androida zainstalowanych przez użytkowników, np. com.google.example.

CustomAudienceMemberType

Enum zawierający możliwe typy członków listy niestandardowych odbiorców.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznana w tej wersji.
`KEYWORD`	Użytkownicy, których zainteresowania lub działania są opisane przez słowo kluczowe.
`URL`	Użytkownicy, którzy mają zainteresowania związane z treściami w witrynie.
`PLACE_CATEGORY`	Użytkownicy, którzy odwiedzają typy miejsc opisane przez kategorię miejsca.
`APP`	Użytkownicy, którzy zainstalowali aplikację mobilną.