Cosa sono i costruttori?

I costruttori vengono usati per aggiungere un'entità. Ogni oggetto padre, ad esempio Campaign, include metodi per ottenere oggetti generatore che utilizzi per aggiungere entità figlio. Ad esempio, per aggiungere un gruppo di annunci a una campagna, occorre chiamare il Campaign metodo dell'oggetto newAdGroupBuilder .

L'oggetto generatore include i metodi utilizzati per impostare i valori delle proprietà dell'entità. Ad esempio, per specificare il CPC di una parola chiave, è necessario usare il withCpc metodo. Dopo aver impostato tutti i valori delle proprietà dell'entità, chiameresti il build metodo per creare l'entità. Il processo di compilazione è un processo asincrono in cui la richiesta viene accodata con altre richieste di compilazione ed elaborata in batch. Le richieste in batch verranno completate prima del termine dello script.

Per determinare se le richieste di compilazione sono riuscite, è possibile esaminare i log o usare l'oggetto operazione restituito dal build metodo. Ad esempio, AdGroupBuilder restituisce AdGroupOperation. Puoi chiamare uno qualsiasi dei metodi dell'oggetto operazione (isSuccessful, getResulto getErrors) per determinare se gli script hanno creato correttamente l'entità. Tuttavia, quando si chiamano questi metodi, ci sono considerazioni sulle prestazioni (vedere Considerazioni sulle prestazioni).

L'esempio seguente mostra concettualmente come creare una parola chiave utilizzando gli oggetti generatore e operazione. Probabilmente dovresti usare questo flusso solo se stai creando una singola entità (o forse alcune).

    // Gets the first ad group in the account.
    var adGroup = AdsApp.adGroups().get().next();

    // Use the 'with' methods to specify the keyword's property values.
    // The .build() method adds the build request to the build queue.
    var keywordOperation = adGroup.newKeywordBuilder()
        .withCpc(1.2)
        .withText("shirts")
        .withFinalUrl("https://www.contoso.com/shirts")
        .build();

    // Call isSuccessful() to determine if the build succeeded.
    // Calling any of the operation object's method processes the
    // build request immediately. 
    if (keywordOperation.isSuccessful()) {
        // You only need to call getResult if you need to access
        // the new keyword entity.
        var keyword = keywordOperation.getResult();
    } else {
        // Handle the errors.
        for (var error of keywordOperation.getErrors()) {
            Logger.log(`${error}\n`);
        }
    }

Considerazioni sulle prestazioni

Per migliorare le prestazioni, Script elabora le richieste di compilazione in batch. Se chiami il metodo operativo di una richiesta di compilazione, forza gli script a elaborare immediatamente le richieste di compilazione in coda, annullando eventuali miglioramenti delle prestazioni. Se stai creando più di un'entità, non eseguire i metodi operativi nello stesso ciclo che usi per creare l'entità. Ciò comporta prestazioni scadenti perché viene elaborata una sola entità alla volta. Creare invece una matrice di operazioni ed elaborarle dopo il ciclo di compilazione.

Eseguire l'operazione seguente

    // An array to hold the operations, so you 
    // can process them after all the entities are queued.
    var operations = []; 

    // Create all the new entities.
    for (var i = 0; i < keywords.length; i++) {
        var keywordOperation = AdsApp.adGroups().get().next()
          .newKeywordBuilder()
          .withText(keywords[i])
          .build();
        operations.push(keywordOperation);
    }

    // Now call the operation method so the build requests
    // get processed in batches.
    for (var i = 0; i < operations.length; i++) {
        var newKeyword = operations[i].getResult();
    }

Cose da evitare

    for (var i = 0; i < keywords.length; i++) {
        var keywordOperation = AdsApp.adGroups().get().next()
          .newKeywordBuilder()
          .withText(keywords[i])
          .build();

        // Don't get results in the same loop that creates
        // the entity because Scripts then only processes one
        // entity at a time.
        var newKeyword = keywordOperation.getResult();
    }

Di seguito è riportato l'elenco dei costruttori.

Passaggi successivi

Informazioni sulla modalità anteprima

  • Ultimo aggiornamento: