BingAdsAccountSelector

Contiene los métodos para filtrar y ordenar la lista de cuentas a las que tiene acceso el usuario. Para obtener información sobre los selectores, consulte Selectores.

Ejemplo de uso:

    var accounts = AccountsApp.accounts()
        .withCondition("Name CONTAINS_IGNORE_CASE 'PARTIAL ACCOUNT NAME GOES HERE'")
        .get();

    while (accounts.hasNext()) {
        var account = accounts.next();
    }

Métodos

Nombre del método Tipo de valor devuelto Description
executeInParallel(string functionName, string optionalCallbackFunctionName) void Ejecuta la función para cada cuenta que devuelve el selector.
executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput) void Ejecuta la función para cada cuenta que devuelve el selector.
forDateRange(Object dateFrom, Object dateTo) BingAdsAccountSelector Aplica las fechas de inicio y finalización para seleccionar métricas de rendimiento.
forDateRange(string dateRange) BingAdsAccountSelector Aplica el intervalo de fechas predefinido para seleccionar las métricas de rendimiento.
get BingAdsAccountIterator Obtiene un iterador que se usa para iterar a través de la lista de cuentas.
orderBy(string orderBy) BingAdsAccountSelector Aplica el orden especificado a las cuentas seleccionadas.
withAccountNumbers(string[] accountNumbers) BingAdsAccountSelector Obtiene cuentas con los números de cuenta especificados.
withCondition(condición de cadena) BingAdsAccountSelector Aplica criterios de filtro a las cuentas.
withIds(string[] ids) BingAdsAccountSelector Obtiene cuentas con los identificadores especificados.
withLimit(int limit) BingAdsAccountSelector Obtiene las n cuentas principales que coinciden con los criterios de selección.

executeInParallel(string functionName, string optionalCallbackFunctionName)

Ejecuta la función para cada cuenta que devuelve el selector. Una vez ejecutada la función para todas las cuentas seleccionadas, Scripts llama a la función de devolución de llamada opcional.

Nota:

El script puede ejecutarse un máximo de 50 cuentas en paralelo cada vez que se ejecute el script. Puede llamar a este método una o varias veces, pero el número total de cuentas con todas las llamadas procesadas no debe superar las 50. Si una llamada supera el límite de 50 cuentas para el script, no se ejecuta ninguna de las cuentas de la llamada. Para limitar el número de cuentas que devuelve el selector, considere la posibilidad de usar el withLimit método o withIds .

La función functionName puede devolver un valor como una cadena. Para devolver un objeto complejo, use el método JSON.stringify para convertir el objeto en una cadena. A continuación, puede usar el método JSON.parse para volver a convertir la cadena en un objeto. Si la función devuelve un valor, debe especificar una función de devolución de llamada para capturar los valores devueltos. A continuación se muestra la firma de la función de devolución de llamada. Los valores devueltos se pasan como una matriz de objetos ExecutionResult .

function myCallback(ExecutionResult[] results)

En el ejemplo siguiente se muestra cómo procesar los valores devueltos en la función de devolución de llamada.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Dado que este método no devuelve un objeto BingAdsAccountSelector , asegúrese de que este método sea el último método selector de la cadena de llamadas.

Para ver un ejemplo, consulte Detectar anuncios no aprobados.

Argumentos

Nombre Tipo Description
functionName string Nombre de la función que se va a ejecutar para cada cuenta que devuelve el selector. El método currentAccount identifica la cuenta que está procesando la función.
optionalCallbackFunctionName string Opcional. Nombre de la función que se va a ejecutar después de que todas las cuentas terminen de ejecutar la función functionName . Esta función solo se ejecuta una vez.

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput)

Ejecuta la función para cada cuenta que devuelve el selector. Una vez que se ejecuta la función para todas las cuentas seleccionadas, Scripts llama a la función de devolución de llamada opcional.

Nota:

El script puede ejecutarse un máximo de 50 cuentas en paralelo cada vez que se ejecute el script. Puede llamar a este método una o varias veces, pero el número total de cuentas con todas las llamadas procesadas no debe superar las 50. Si una llamada supera el límite de 50 cuentas para el script, no se ejecuta ninguna de las cuentas de la llamada. Para limitar el número de cuentas que devuelve el selector, considere la posibilidad de usar el withLimit método o withIds .

La función functionName puede devolver un valor como una cadena. Para devolver un objeto complejo, use el método JSON.stringify para convertir el objeto en una cadena. A continuación, puede usar el método JSON.parse para volver a convertir la cadena en un objeto. Si la función devuelve un valor, debe especificar una función de devolución de llamada para capturar los valores devueltos. A continuación se muestra la firma de la función de devolución de llamada. Los valores devueltos se pasan como una matriz de objetos ExecutionResult .

function myCallback(ExecutionResult[] results)

En el ejemplo siguiente se muestra cómo procesar los valores devueltos en la función de devolución de llamada.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Si pasa el parámetro de entrada opcional, lo siguiente muestra la firma de la función functionName .

function myFunction(string optionalInput)

Dado que este método no devuelve un objeto BingAdsAccountSelector , asegúrese de que este método sea el último método selector de la cadena de llamadas.

Para ver un ejemplo, consulte Detectar anuncios no aprobados.

Argumentos

Nombre Tipo Description
functionName string Nombre de la función que se va a ejecutar para cada cuenta que devuelve el selector. El método currentAccount identifica la cuenta que está procesando la función.
optionalCallbackFunctionName string Opcional. Nombre de la función que se va a ejecutar después de que todas las cuentas terminen de ejecutar la función functionName . Esta función solo se ejecuta una vez.
optionalInput string Opcional. Entrada para pasar a la función functionName .

Valores devueltos

Tipo Description
void Devuelve el valor nothing.

forDateRange(Object dateFrom, Object dateTo)

Aplica las fechas de inicio y finalización para seleccionar métricas de rendimiento.

Especifique un intervalo de fechas únicamente si:

  • Se aplican condiciones u órdenes que hacen referencia a campos de métricas de rendimiento.
  • Desea obtener datos de rendimiento para los objetos que está seleccionando. Por ejemplo, si tiene previsto getStats() llamar al método.

Puede especificar los parámetros de fecha mediante cadenas u objetos. Para usar cadenas, especifique la fecha con el formato AAAAMMDD. Si utiliza objetos, cree un objeto con los siguientes campos:

  • year
  • month
  • día

Por ejemplo:

var date = {year: 2018, month: 5, day: 13};

El mes es de una sola base, donde 1 es enero y 12 es diciembre.

El intervalo de fechas es inclusivo. Si especifica varios intervalos de fechas, solo se usará el último intervalo de fechas.

Argumentos

Nombre Tipo Description
dateFrom Objeto Fecha de inicio del intervalo de fechas que especifica los datos de rendimiento que se incluirán en el selector.
dateTo Objeto Fecha de finalización del intervalo de fechas que especifica los datos de rendimiento que se incluirán en el selector.

Valores devueltos

Tipo Description
BingAdsAccountSelector Selector con intervalo de fechas aplicado.

forDateRange(String dateRange)

Aplica el intervalo de fechas predefinido para seleccionar las métricas de rendimiento.

Valores de intervalo de fechas admitidos:

  • HOY
  • AYER
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Especifique un intervalo de fechas únicamente si:

  • Se aplican condiciones u órdenes que hacen referencia a campos de métricas de rendimiento.
  • Desea obtener datos de rendimiento para los objetos que está seleccionando. Por ejemplo, si tiene previsto getStats() llamar al método.

Si especifica varios intervalos de fechas, solo se usará el último intervalo de fechas.

Argumentos

Nombre Tipo Description
Intervalo de fechas Cadena La cadena de intervalo de fechas predefinida que especifica los datos de rendimiento que se incluirán en el selector. La cadena de intervalo de fechas predefinida distingue mayúsculas de minúsculas.

Valores devueltos

Tipo Description
BingAdsAccountSelector Selector con intervalo de fechas aplicado.

obtener

Obtiene un iterador que se usa para iterar a través de la lista de cuentas.

Valores devueltos

Tipo Description
BingAdsAccount Iterador usado para iterar a través de las cuentas seleccionadas.

orderBy(string orderBy)

Aplica el orden especificado a las cuentas seleccionadas.

Especifique el parámetro orderBy en el formulario "columnName orderDirection" donde:

  • columnName es una de las columnas admitidas.
  • orderDirection es el orden en el que se ordenarán los resultados. Establezca ASC para ordenar los resultados en orden ascendente o DESC para ordenar los resultados en orden descendente. El valor predeterminado es ASC.

Por ejemplo, la siguiente llamada devuelve los resultados en orden ascendente por clics.

selector = selector.orderBy("Clicks");

Los selectores admiten entidades de orden por un solo campo. No puede ordenar la lista de entidades por el campo x, y dentro de x por el campo y, etc. Si especifica más de una orderBy() llamada en una cadena o en selectores independientes, los scripts ordenan la lista de entidades mediante el campo especificado en la última orderBy() llamada. 

Argumentos

Nombre Tipo Description
orderBy string La orden de aplicar.

Valores devueltos

Tipo Description
BingAdsAccountSelector Selector con orden aplicado.

withAccountNumbers(string[] accountNumbers)

Obtiene cuentas con los números de cuenta especificados.

Argumentos

Nombre Tipo Description
accountNumbers string[] Una matriz de números de cuenta. Para conocer los límites, consulte Límites de ejecución de scripts.

Valores devueltos

Tipo Description
BingAdsAccountSelector Selector con los números de cuenta aplicados.

withCondition(condición de cadena)

Aplica criterios de filtro a las cuentas.

Especifique el parámetro de condición en el formulario "valor del operador columnName" donde:

Operadores

El operador que use depende del tipo de columna. Los operadores distinguen mayúsculas de minúsculas. Por ejemplo, use STARTS_WITH en lugar de starts_with.

Operadores para columnas que contienen enteros y valores largos:

<
<=
>
>=
=
!=

Operadores para columnas que contienen valores dobles:

<
>

Operadores de columnas que contienen valores de cadena:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para columnas que contienen valores de enumeración:

=
!=
IN []
NOT_IN []

Operadores de columnas que contienen una matriz de cadenas:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Columnas admitidas para el filtrado de cuentas. Los nombres de columna distinguen mayúsculas de minúsculas.

Las siguientes son las columnas de métricas de rendimiento que puede especificar.

Column Tipo Ejemplo Filtro de interfaz de usuario web de Microsoft Advertising
ClickConversionRate double withCondition("ClickConversionRate > 0.25") Tasa de conversión
Clics largo withCondition("Clicks >= 33") Clics
ConversionedClicks largo withCondition("ConvertedClicks >= 10") Conv.
Costo double withCondition("Cost > 3.25")

El coste está en la moneda de la cuenta.		 Gasto
CTR double withCondition("Ctr > 0.05")

El CTR está en el rango 0..1, así que use 0.05 para un CTR del 5%.		 CTR
Impresiones largo withCondition("Impressions > 10") Impr.

Las siguientes son las propiedades de la cuenta que puede especificar.

Column Tipo Ejemplo Filtro de interfaz de usuario web de Microsoft Advertising
CurrencyCode string El código de la moneda que usa la cuenta. Por ejemplo, USD por dólar de Estados Unidos.

withCondition("CurrencyCode = USD")
ManagerCustomerId string El id. de cliente del usuario que administra las cuentas.

withCondition("ManagerCustomerId = '123456789'")
Nombre string El nombre de una cuenta administrada.

withCondition("Name CONTAINS_IGNORE_CASE 'foo'")

Argumentos

Nombre Tipo Description
condición string Condición que se va a agregar al selector.

Valores devueltos

Tipo Description
BingAdsAccountSelector Selector con la condición aplicada.

withIds(string[] ids)

Obtiene cuentas con los identificadores especificados.

Puede aplicar una o más condiciones a un selector. Una cadena de condiciones se considera una operación AND. Por ejemplo, la entidad solo se selecciona si la condición A es verdadera Y la condición B es verdadera. Por ejemplo, la siguiente llamada selecciona solo la cuenta 33333.

AccountsApp.accounts()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);
    .get();

Argumentos

Nombre Tipo Descripción
ids string[] Una matriz de identificadores de cuenta. Para conocer los límites, consulte Límites de ejecución de scripts.

Valores devueltos

Tipo Description
BingAdsAccountSelector con los identificadores aplicados.

withLimit(int limit)

Obtiene las n cuentas principales que coinciden con los criterios de selección.

Argumentos

Nombre Tipo Description
límite Entero El número de cuentas que se devolverán. El número real puede ser menor.

Valores devueltos

Tipo Description
BingAdsAccountSelector Selector con límite aplicado.

Vea también

  • Last updated on