A API Campaign Manager 360 v3.4 foi descontinuada e será desativada em 24 de dezembro de 2021. Até essa data, todos os usuários precisam migrar para uma versão mais recente da API.

AccountUserProfiles

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

AccountUserProfiles contém propriedades de um perfil de usuário do Campaign Manager. Esse recurso serve especificamente para gerenciar perfis de usuário, enquanto UserProfiles serve para acessar a API.

{
  "kind": "dfareporting#accountUserProfile",
  "id": long,
  "name": string,
  "email": string,
  "accountId": long,
  "subaccountId": long,
  "locale": string,
  "userRoleId": long,
  "userAccessType": string,
  "active": boolean,
  "comments": string,
  "traffickerType": string,
  "campaignFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  },
  "siteFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  },
  "userRoleFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  },
  "advertiserFilter": {
    "kind": "dfareporting#objectFilter",
    "objectIds": [
      long
    ],
    "status": string
  }
}
Nome da propriedade Valor Descrição Notas
accountId long ID da conta do perfil de usuário. Este é um campo somente leitura que pode ser deixado em branco.
active boolean Indica se o perfil de usuário está ativo. O padrão é "false". Para a inserção do perfil do usuário, precisa ser definido como "true".
advertiserFilter nested object Filtro que descreve quais anunciantes estão visíveis para o perfil de usuário.
advertiserFilter.kind string Tipo de recurso em questão. Valor: a string fixa "dfareporting#objectFilter".
advertiserFilter.objectIds[] list Aplicável quando o status é ASSIGNED. O usuário tem acesso a objetos com esses IDs de objeto.
advertiserFilter.status string Status do filtro. NONE significa que o usuário não tem acesso a nenhum dos objetos. ALL significa que o usuário tem acesso a todos os objetos. ASSIGNED significa que o usuário tem acesso aos objetos com IDs na lista objectIds.

Os valores aceitáveis são:
  • "ALL"
  • "ASSIGNED"
  • "NONE"
campaignFilter nested object Filtro que descreve quais campanhas estão visíveis para o perfil do usuário.
campaignFilter.kind string Tipo de recurso em questão. Valor: a string fixa "dfareporting#objectFilter".
campaignFilter.objectIds[] list Aplicável quando o status é ASSIGNED. O usuário tem acesso a objetos com esses IDs de objeto.
campaignFilter.status string Status do filtro. NONE significa que o usuário não tem acesso a nenhum dos objetos. ALL significa que o usuário tem acesso a todos os objetos. ASSIGNED significa que o usuário tem acesso aos objetos com IDs na lista objectIds.

Os valores aceitáveis são:
  • "ALL"
  • "ASSIGNED"
  • "NONE"
comments string Comentários para esse perfil de usuário.
email string E-mail do perfil de usuário. Os endereços de e-mail precisam estar vinculados a uma Conta do Google. Este campo é obrigatório na inserção e somente leitura depois disso.
id long ID do perfil de usuário. Este é um campo somente leitura gerado automaticamente.
kind string Tipo de recurso em questão. Valor: a string fixa "dfareporting#accountUserProfile".
locale string Localidade do perfil de usuário. Este campo é obrigatório.

Os valores aceitáveis são:

  • "cs" (tcheco)
  • "de" (alemão)
  • "en" (inglês)
  • "en-GB" (inglês do Reino Unido)
  • "es" (espanhol)
  • "fr" (francês)
  • "it" (italiano)
  • "ja" (japonês)
  • "ko" (coreano)
  • "pl" (polonês)
  • "pt-BR" (português do Brasil)
  • "ru" (russo)
  • "sv" (sueco)
  • "tr" (turco)
  • "zh-CN" (chinês simplificado)
  • "zh-TW" (chinês tradicional)

name string Nome do perfil de usuário. Este campo é obrigatório. Precisa ter menos de 64 caracteres, ser globalmente exclusivo e não pode conter espaços em branco nem os seguintes caracteres: "&;<>"#%,".
siteFilter nested object Sites visíveis para o perfil de usuário.
siteFilter.kind string Tipo de recurso em questão. Valor: a string fixa "dfareporting#objectFilter".
siteFilter.objectIds[] list Aplicável quando o status é ASSIGNED. O usuário tem acesso a objetos com esses IDs de objeto.
siteFilter.status string Status do filtro. NONE significa que o usuário não tem acesso a nenhum dos objetos. ALL significa que o usuário tem acesso a todos os objetos. ASSIGNED significa que o usuário tem acesso aos objetos com IDs na lista objectIds.

Os valores aceitáveis são:
  • "ALL"
  • "ASSIGNED"
  • "NONE"
subaccountId long ID da subconta do perfil de usuário. Este é um campo somente leitura que pode ser deixado em branco.
traffickerType string Tipo de coordenador de publicidade desse perfil de usuário. Este é um campo somente leitura.

Os valores aceitáveis são:
  • "EXTERNAL_TRAFFICKER"
  • "INTERNAL_NON_TRAFFICKER"
  • "INTERNAL_TRAFFICKER"
userAccessType string Tipo de usuário do perfil de usuário. Este é um campo somente leitura que pode ser deixado em branco.

Os valores aceitáveis são os seguintes:
  • "INTERNAL_ADMINISTRATOR"
  • "NORMAL_USER"
  • "READ_ONLY_SUPER_USER"
  • "SUPER_USER"
userRoleFilter nested object Funções do usuário visíveis para o perfil de usuário.
userRoleFilter.kind string Tipo de recurso em questão. Valor: a string fixa "dfareporting#objectFilter".
userRoleFilter.objectIds[] list Aplicável quando o status é ASSIGNED. O usuário tem acesso a objetos com esses IDs de objeto.
userRoleFilter.status string Status do filtro. NONE significa que o usuário não tem acesso a nenhum dos objetos. ALL significa que o usuário tem acesso a todos os objetos. ASSIGNED significa que o usuário tem acesso aos objetos com IDs na lista objectIds.

Os valores aceitáveis são:
  • "ALL"
  • "ASSIGNED"
  • "NONE"
userRoleId long ID da função do usuário do perfil do usuário. Este campo é obrigatório.

Métodos

get
Recupera um perfil de usuário da conta por ID.
insert
Insere um novo perfil do usuário da conta.
list
Recupera uma lista de perfis de usuário da conta, possivelmente filtrada. Esse método é compatível com paginação.
patch
Atualiza um perfil de usuário da conta existente. Esse método é compatível com a semântica de patch.
update
Atualiza um perfil de usuário da conta existente.