Macros: update

Wymaga autoryzacji

Aktualizuje makro Menedżera tagów Google. Wypróbuj lub zobacz przykład.

Prośba

Żądanie HTTP

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

Parametry

Nazwa parametru	Wartość	Opis
Parametry ścieżki
accountId	string	Identyfikator konta Menedżera tagów Google.
containerId	string	Identyfikator kontenera Menedżera tagów Google.
macroId	string	Identyfikator makra Menedżera tagów Google.
Opcjonalne parametry zapytania
fingerprint	string	Jeśli odcisk cyfrowy jest podany, musi być zgodny z odciskiem cyfrowym makra w pamięci.

Upoważnienie

To żądanie wymaga autoryzacji z tym zakresem (więcej informacji o uwierzytelnianiu i autoryzacji).

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

Treść żądania

W treści żądania podaj zasób makr z tymi właściwościami:

nazwa usługi,	Wartość	Opis	Uwagi
Właściwości wymagane
parameter[].type	string	Typ parametru. Prawidłowe wartości to: boolean: wartość jest wartością logiczną „true” (prawda) lub „false” (fałsz). integer: wartość przedstawia 64-bitową liczbę całkowitą ze znakiem w systemie 10 list: należy określić listę parametrów map: należy określić mapę parametrów template: wartość reprezentuje dowolny tekst; może to obejmować odwołania do makr (nawet odwołania do makr, które mogą zwracać typy niebędące ciągami znaków). Akceptowane wartości: "boolean" "integer" "list" "map" "template"	z możliwością zapisu
type	string	Typ makra Menedżera tagów Google.	z możliwością zapisu
Właściwości opcjonalne
disablingRuleId[]	list	Tylko kontenery mobilne: lista identyfikatorów reguł służących do wyłączania makr warunkowych. Makro jest włączone, jeśli jedna z reguł włączających jest prawda, a wszystkie reguły wyłączone mają wartość fałsz. Zbiór traktowany jako nieuporządkowany.	z możliwością zapisu
enablingRuleId[]	list	Tylko kontenery mobilne: lista identyfikatorów reguł do włączania makr warunkowych. Makro jest włączone, jeśli jedna z reguł włączających jest prawda, a wszystkie reguły wyłączające – fałsz. Zbiór traktowany jako nieuporządkowany.	z możliwością zapisu
name	string	Wyświetlana nazwa makra.	z możliwością zapisu
notes	string	Uwagi użytkownika na temat zastosowania tego makra w kontenerze.	z możliwością zapisu
parameter[]	list	Parametry makra.	z możliwością zapisu
parameter[].key	string	Nazwany klucz, który jednoznacznie identyfikuje parametr. Wymagane dla parametrów najwyższego poziomu oraz wartości mapy. Ignorowana w przypadku wartości list.	z możliwością zapisu
parameter[].list[]	list	Parametry tego parametru listy (klucze będą ignorowane).	z możliwością zapisu
parameter[].map[]	list	Parametry tego parametru mapy (muszą mieć klucze, a klucze muszą być unikalne).	z możliwością zapisu
parameter[].value	string	Wartość parametru (może zawierać odwołania do makr, np. „”), odpowiednio do określonego typu.	z możliwością zapisu
scheduleEndMs	long	Sygnatura czasowa zakończenia (w milisekundach), która umożliwia zaplanowanie makra.	z możliwością zapisu
scheduleStartMs	long	Sygnatura czasowa rozpoczęcia (w milisekundach) planowania makra.	z możliwością zapisu

Odpowiedź

Jeśli operacja się uda, metoda zwróci w treści odpowiedzi zasób makr.

Przykłady

Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.

Java

Korzysta z biblioteki klienta Java.

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

/*
 * This request updates an existing macro for the authorized user.
 */

// Construct the macro object.
Macro macro = new Macro();
macro.setName("Updated 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().update("123456", "54321", "18", macro).execute();

} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Używa biblioteki klienta dla języka Python.

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

# This request updates an existing macro for the authorized user.
try:
  response = tagmanager.accounts().containers().macros().update(
      accountId='123456',
      containerId='54321',
      macroId='19',
      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 update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Wypróbuj

Użyj Eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.