Macros: create

Richiede l'autorizzazione

Crea una macro GTM. Prova subito o guarda un esempio.

Richiesta

Richiesta HTTP

POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/macros

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
accountId string L'ID account GTM.
containerId string L'ID contenitore GTM.

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito (scopri di più su autenticazione e autorizzazione).

Ambito
https://www.googleapis.com/auth/tagmanager.edit.containers

Corpo della richiesta

Nel corpo della richiesta, fornisci una risorsa Macro con le seguenti proprietà:

Nome proprietà Valore Descrizione Note
Proprietà obbligatorie
name string Nome visualizzato della macro. scrivibile
parameter[].type string Il tipo di parametro. I valori validi sono:
  • boolean: il valore rappresenta un valore booleano, rappresentato come "true" o "false"
  • integer: il valore rappresenta un valore intero con segno a 64 bit, in base 10
  • list: è necessario specificare un elenco di parametri
  • map: è necessario specificare una mappa dei parametri
  • template: il valore rappresenta qualsiasi testo; possono essere inclusi riferimenti alle macro (anche riferimenti alle macro che potrebbero restituire tipi diversi da una stringa)


I valori accettati sono:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
 scrivibile
type string Tipo di macro GTM. scrivibile
Proprietà facoltative
disablingRuleId[] list Solo per i contenitori per dispositivi mobili: un elenco di ID regola per la disattivazione delle macro condizionali; la macro viene attivata se una delle regole di attivazione è vera e tutte le regole di disattivazione sono false. Sono considerati come un insieme non ordinato. scrivibile
enablingRuleId[] list Solo per i contenitori per dispositivi mobili: un elenco di ID regola per l'attivazione di macro condizionali; la macro viene attivata se una delle regole di attivazione è vera e tutte le regole di disattivazione sono false. Sono considerati come un insieme non ordinato. scrivibile
notes string Note dell'utente su come applicare questa macro nel contenitore. scrivibile
parameter[] list I parametri della macro. scrivibile
parameter[].key string La chiave denominata che identifica in modo univoco un parametro. Obbligatorio per i parametri di primo livello e per i valori della mappa. Ignorato per i valori dell'elenco. scrivibile
parameter[].list[] list Parametri di questo parametro elenco (le chiavi verranno ignorate). scrivibile
parameter[].map[] list I parametri di questo parametro mappa (devono essere dotati di chiavi; le chiavi devono essere univoche). scrivibile
parameter[].value string Il valore di un parametro (può contenere riferimenti a macro come "") a seconda del tipo specificato. scrivibile
scheduleEndMs long Il timestamp di fine in millisecondi per pianificare una macro. scrivibile
scheduleStartMs long Il timestamp di inizio in millisecondi per pianificare una macro. scrivibile

Risposta

In caso di esito positivo, questo metodo restituisce una risorsa Macro nel corpo della risposta.

Esempi

Nota: gli esempi di codice disponibili per questo metodo non rappresentano tutti i linguaggi di programmazione supportati (consulta la pagina relativa alle librerie client per un elenco dei linguaggi supportati).

Java

Utilizza la libreria client Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request creates a new macro for the authorized user.
 */

// Construct the macro object.
Macro macro = new Macro();
macro.setName("Sample URL Macro");
macro.setType("u");

// Construct the parameters.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("component");
arg0.setValue("URL");

Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("customUrlSource");
arg1.setValue("{{element}}");

// set the parameters on the macro.
macro.setParameter(Arrays.asList(arg0, arg1));

try {
  Macro response = tagmanager.accounts().
      containers().macros().create("123456", "54321", macro).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the create method are stored in the response object.
 * The following code shows how to access the created Id and Fingerprint.
 */
System.out.println("Macro Id = " + response.getMacroId());
System.out.println("Macro Fingerprint = " + response.getFingerprint());

Python

Utilizza la libreria client Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request creates a new macro for the authorized user.
try:
  response = tagmanager.accounts().containers().macros().create(
      accountId='123456',
      containerId='54321',
      body={
          'name': 'Sample URL Macro',
          'type': 'u',
          'parameter': [
              {
                  'type': 'template',
                  'key': 'component',
                  'value': 'URL'
              },
              {
                  'type': 'template',
                  'key': 'customUrlSource',
                  'value': '{{element}}'
              }
          ]
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the create method are stored in the response object.
# The following code shows how to access the created id and fingerprint.
print 'Macro Id = %s' % response.get('macroId')
print 'Macro Fingerprint = %s' % response.get('fingerprint')

Prova.

Utilizza Explorer API di seguito per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.