Compartir a través de


ProductGroup

Objeto de grupo de productos base, que contiene los métodos utilizados para administrar un grupo de productos.

Ejemplo de uso:

    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

    var productGroups = shoppingCampaign.productGroups().get();

    while (productGroups.hasNext()) {
        var group = productGroups.next();
    }

Métodos

Nombre del método Tipo de valor devuelto Descripción
asBrand ProductBrand Convierte el grupo de productos en un grupo de productos de marca.
asCategory ProductCategory Convierte el grupo de productos en un grupo de productos de categoría.
asChannel ProductChannel Convierte el grupo de productos en un grupo de productos de canal.
asChannelExclusivity ProductChannelExclusivity Convierte el grupo de productos en un grupo de productos de exclusividad de canal.
asCondition ProductCondition Convierte el grupo de productos en un grupo de productos de condición.
asCustomLabel ProductCustomLabel Convierte el grupo de productos en un grupo de productos de etiqueta personalizado.
asItemId ProductItemId Convierte el grupo de productos en un grupo de productos de id. de elemento.
asProductType ProductType Convierte el grupo de productos en un grupo de productos de tipo de producto.
secundario ProductGroupSelector Obtiene un selector que se usa para filtrar la lista de grupos de productos secundarios de este grupo de productos.
getAdGroup Adgroup Obtiene el grupo de anuncios al que pertenece este grupo de productos.
getCampaign Campaña Obtiene la campaña a la que pertenece este grupo de productos.
getDimension string Obtiene la dimensión de este grupo de productos.
getEntityType string Obtiene el tipo de esta entidad.
getId string Obtiene el identificador que identifica de forma única este grupo de productos.
getMaxCpc double Obtiene el importe máximo de la puja de costo por clic para este grupo de productos.
getStats Estadísticas Obtiene los datos de rendimiento de este grupo de productos.
Getvalue Cadena Obtiene el valor de este grupo de productos.
isExcluded Booleano Obtiene un valor booleano que determina si se excluye este grupo de productos.
isOtherCase Booleano Obtiene un valor booleano que determina si este grupo de productos representa todos los demás casos no representados por su grupo de productos del mismo nivel.
primario ProductGroup Obtiene el grupo de productos primario de este grupo de productos.
setMaxCpc(double cpc) void Establece el importe máximo de puja de costo por clic que se usará para este grupo de productos.

asBrand

Convierte este grupo de productos en un grupo de productos de marca.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos de marca para acceder al valor de la marca. Puede acceder al valor de la marca llamando al método getValue .

Valores devueltos

Tipo Descripción
ProductBrand Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

asCategory

Convierte este grupo de productos en un grupo de productos de categoría.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos de categoría para acceder al valor de la categoría. Puede acceder al valor de la categoría llamando al método getValue .

Valores devueltos

Tipo Descripción
ProductCategory Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

asChannel

Convierte este grupo de productos en un grupo de productos de canal.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos de canal para acceder al valor del canal. Puede acceder al valor del canal llamando al método getValue .

Valores devueltos

Tipo Descripción
ProductChannel Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

asChannelExclusivity

Convierte este grupo de productos en un grupo de productos de exclusividad de canal.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos de exclusividad de canal para acceder al valor del canal. Puede acceder al valor del canal llamando al método getValue .

Valores devueltos

Tipo Descripción
ProductChannelExclusivity Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

asCondition

Convierte este grupo de productos en un grupo de productos de condición.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos de condición para acceder al valor de la condición. Puede acceder al valor de la condición llamando al método getValue .

Valores devueltos

Tipo Descripción
ProductCondition Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

asCustomLabel

Convierte este grupo de productos en un grupo de productos de etiqueta personalizado.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos CustomLabel para acceder al valor de la etiqueta. Puede acceder al valor de la etiqueta llamando al método getValue . Solo tiene que convertir el grupo de productos en CustomLabel si necesita saber para qué tipo de etiqueta es el valor. Por ejemplo, la etiqueta personalizada 0 a 4.

Valores devueltos

Tipo Descripción
ProductCustomLabel Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

asItemId

Convierte este grupo de productos en un grupo de productos de id. de elemento.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos ItemId para acceder al valor del identificador. Puede acceder al valor del identificador llamando al método getValue .

Valores devueltos

Tipo Descripción
ProductItemId Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

asProductType

Convierte este grupo de productos en un grupo de productos de tipo de producto.

Nota:

No es necesario convertir el grupo de productos en un grupo de productos ProductType para tener acceso al valor del tipo. Puede acceder al valor del tipo llamando al método getValue . Solo tiene que convertir el grupo de productos en ProductType si necesita saber para qué tipo es el valor. Por ejemplo, PRODUCT_TYPE_L1, etc.

Valores devueltos

Tipo Descripción
ProductType Contiene los métodos utilizados para acceder a las propiedades del grupo de productos.

secundario

Obtiene un selector usado para filtrar la lista de grupos de productos secundarios de este grupo de productos.

Valores devueltos

Tipo Descripción
ProductGroupSelector Selector que se usa para filtrar la lista de elementos secundarios de este grupo de productos.

getAdGroup

Obtiene el grupo de anuncios al que pertenece este grupo de productos.

Valores devueltos

Tipo Descripción
Adgroup Grupo de anuncios al que pertenece este grupo de productos.

getCampaign

Obtiene la campaña a la que pertenece este grupo de productos.

Valores devueltos

Tipo Descripción
Campaña Campaña a la que pertenece este grupo de productos.

getDimension

Obtiene la dimensión de este grupo de productos.

Valores devueltos

Tipo Descripción
Cadena Dimensión de este grupo de productos. Los posibles valores son:
  • RAÍZ: la parte superior del árbol
  • MARCA
  • CATEGORÍA
  • CONDICIÓN
  • CUSTOM_LABEL
  • ITEM_ID
  • PRODUCT_TYPE

getEntityType

Obtiene el tipo de esta entidad.

Valores devueltos

Tipo Descripción
string Tipo de esta entidad, que es ProductGroup.

getId

Obtiene el identificador que identifica de forma única este grupo de productos.

Valores devueltos

Tipo Descripción
string Identificador que identifica de forma única este grupo de productos.

getMaxCpc

Obtiene el importe máximo de la oferta de costo por clic de este grupo de productos.

Valores devueltos

Tipo Descripción
double El importe de la oferta. Devuelve null si no se establece o se trata de un grupo de productos negativo (isExluded es true).

getStats

Obtiene los datos de rendimiento de este grupo de productos.

Para llamar a este método, debe incluir uno de los forDateRange métodos en la cadena del selector del grupo de productos.

Valores devueltos:

Tipo Descripción
Estadísticas Los datos de rendimiento de este grupo de productos.

Getvalue

Obtiene el valor de este grupo de productos.

Valores devueltos:

Tipo Descripción
Cadena Valor de este grupo de productos. Devuelve null si se trata del grupo raíz.

isExcluded

Obtiene un valor booleano que determina si este grupo de productos es un grupo de productos negativo.

Valores devueltos:

Tipo Descripción
Booleano Es true si este grupo de productos es un grupo negativo; De lo contrario, false. Por ejemplo, en lugar de incluir todos los esquís de descenso, los excluirá.

isOtherCase

Obtiene un valor booleano que determina si este grupo de productos representa todo lo demás no representado por su grupo de productos del mismo nivel (es decir, el otro caso).

Valores devueltos:

Tipo Descripción
Booleano Es true si este grupo de productos representa el caso "otro"; De lo contrario, false. Por ejemplo, si divide Todos los productos (el nodo raíz) por Sporting Goods, el servicio crea un grupo de productos del mismo nivel que representa los productos que no están en Sporting Goods y establece este campo en true. El identificador primario de este grupo de productos y el grupo de productos Sporting Goods apuntan al nodo raíz.

primario

Obtiene el elemento primario de este grupo de productos.

Valores devueltos:

Tipo Descripción
ProductGroup El elemento primario de este grupo de productos. Devuelve null si se trata del grupo raíz.

setMaxCpc(double cpc)

Establece el importe máximo de la puja de costo por clic para este grupo de productos.

Argumentos

Nombre Tipo Descripción
Cpc double El importe de la oferta. El importe de la puja se encuentra en la moneda de la cuenta, que determina los valores de puja mínimos y máximos que puede especificar. No establezca la oferta si este grupo de productos está subdividido (tiene elementos secundarios) o es un grupo de productos negativo (isExcluded es true).

Valores devueltos

Tipo Descripción
void Devuelve el valor nothing.