Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiornare gli oggetti Passes Corsi e Pass

Mantenere aggiornate le tessere è un modo importante per interagire con i tuoi clienti e creare un'esperienza positiva.

È possibile aggiornare due risorse: LoyaltyClass e LoyaltyObject.

Best practice

Il seguente elenco contiene informazioni utili da prendere in considerazione durante l'aggiornamento classi e oggetti delle carte fedeltà:

Quando vuoi aggiornare un'intera classe o un oggetto, invia una richiesta update. Quando vuoi aggiornare un numero ridotto di campi in una classe o in un oggetto, invia una richiesta patch.
Quando effettui una richiesta update, viene aggiornato l'intero oggetto o la classe. Ciò significa che tutti i campi non inclusi nella richiesta verranno cancellati. Prima di inviare una richiesta update, ti consigliamo di inviare una richiesta GET a assicurarsi di utilizzare la versione più recente e tutte le sono inclusi nella tua richiesta.
Quando effettui una richiesta patch, solo i campi con patch vengono applicati aggiornato. Prima di inviare una richiesta patch, valuta la possibilità di inviare un GET richiesta di confronto delle tue modifiche con l'ultima versione.
Quando si effettuano patch richieste di aggiornamento degli array, l'array originale viene sostituito con quello incluso nel corpo della richiesta. Non puoi modificare in un array singolarmente.
In alcuni casi, potresti non sapere quando vengono apportate modifiche o quando attivarle aggiornamenti. Valuta la possibilità di pianificare periodicamente richieste di update o patch per tutte le classi e gli oggetti.

Aggiorna una classe di pass

Utilizzare la Business Console di Google Wallet

Le classi di accesso (non gli oggetti) possono essere modificate direttamente nella Google Pay e Console Wallet.

Vai alla console
Seleziona API Google Wallet
Seleziona il corso da modificare.
Seleziona Modifica.
Aggiornare le proprietà dei corsi
Seleziona Salva.

Una volta salvate le modifiche, il corso viene aggiornato automaticamente per qualsiasi titolari di programmi fedeltà.

Utilizzare l'API Google Wallet

L'aggiornamento di LoyaltyClass interessa tutti gli utenti di cui è stato eseguito il provisioning. carte fedeltà che utilizzano questa classe. Ad esempio, per aggiornare il logo le tue carte fedeltà, dovrai inviare una richiesta update o patch a l'API Google Wallet in uno dei seguenti endpoint. resourceId sarebbe l'ID classe (ISSUER_ID.CLASS_SUFFIX).

# Update
PUT https://walletobjects.googleapis.com/walletobjects/v1/loyaltyclass/{resourceId}

# Patch
PATCH https://walletobjects.googleapis.com/walletobjects/v1/loyaltyclass/{resourceId}

Per ulteriori informazioni, consulta Riferimento API.

Java

Per avviare l'integrazione in Java, consulta la nostra documentazione di esempi di codice su GitHub.

/**
 * Update a class.
 *
 * <p><strong>Warning:</strong> This replaces all existing class attributes!
 *
 * @param issuerId The issuer ID being used for this request.
 * @param classSuffix Developer-defined unique ID for this pass class.
 * @return The pass class ID: "{issuerId}.{classSuffix}"
 */
public String updateClass(String issuerId, String classSuffix) throws IOException {
  LoyaltyClass updatedClass;

  // Check if the class exists
  try {
    updatedClass =
        service.loyaltyclass().get(String.format("%s.%s", issuerId, classSuffix)).execute();
  } catch (GoogleJsonResponseException ex) {
    if (ex.getStatusCode() == 404) {
      // Class does not exist
      System.out.printf("Class %s.%s not found!%n", issuerId, classSuffix);
      return String.format("%s.%s", issuerId, classSuffix);
    } else {
      // Something else went wrong...
      ex.printStackTrace();
      return String.format("%s.%s", issuerId, classSuffix);
    }
  }

  // Class exists
  // Update the class by adding a homepage
  updatedClass.setHomepageUri(
      new Uri()
          .setUri("https://developers.google.com/wallet")
          .setDescription("Homepage description"));

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  updatedClass.setReviewStatus("UNDER_REVIEW");

  LoyaltyClass response =
      service
          .loyaltyclass()
          .update(String.format("%s.%s", issuerId, classSuffix), updatedClass)
          .execute();

  System.out.println("Class update response");
  System.out.println(response.toPrettyString());

  return response.getId();
}

PHP

Per avviare l'integrazione in PHP, consulta le di esempi di codice su GitHub.

/**
 * Update a class.
 *
 * **Warning:** This replaces all existing class attributes!
 *
 * @param string $issuerId The issuer ID being used for this request.
 * @param string $classSuffix Developer-defined unique ID for this pass class.
 *
 * @return string The pass class ID: "{$issuerId}.{$classSuffix}"
 */
public function updateClass(string $issuerId, string $classSuffix)
{
  // Check if the class exists
  try {
    $updatedClass = $this->service->loyaltyclass->get("{$issuerId}.{$classSuffix}");
  } catch (Google\Service\Exception $ex) {
    if (!empty($ex->getErrors()) && $ex->getErrors()[0]['reason'] == 'classNotFound'
    ) {
      // Class does not exist
      print("Class {$issuerId}.{$classSuffix} not found!");
      return "{$issuerId}.{$classSuffix}";
    } else {
      // Something else went wrong...
      print_r($ex);
      return "{$issuerId}.{$classSuffix}";
    }
  }

  // Update the class by adding a homepage
  $updatedClass->setHomepageUri(new Uri([
      'uri' => 'https://developers.google.com/wallet',
      'description' => 'Homepage description'
    ]));

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  $updatedClass->setReviewStatus('UNDER_REVIEW');

  $response = $this->service->loyaltyclass->update("{$issuerId}.{$classSuffix}", $updatedClass);

  print "Class update response\n";
  print_r($response);

  return $response->id;
}

Python

Per avviare l'integrazione in Python, consulta le di esempi di codice su GitHub.

def update_class(self, issuer_id: str, class_suffix: str) -> str:
    """Update a class.

    **Warning:** This replaces all existing class attributes!

    Args:
        issuer_id (str): The issuer ID being used for this request.
        class_suffix (str): Developer-defined unique ID for this pass class.

    Returns:
        The pass class ID: f"{issuer_id}.{class_suffix}"
    """

    # Check if the class exists
    try:
        response = self.client.loyaltyclass().get(resourceId=f'{issuer_id}.{class_suffix}').execute()
    except HttpError as e:
        if e.status_code == 404:
            print(f'Class {issuer_id}.{class_suffix} not found!')
            return f'{issuer_id}.{class_suffix}'
        else:
            # Something else went wrong...
            print(e.error_details)
            return f'{issuer_id}.{class_suffix}'

    # Class exists
    updated_class = response

    # Update the class by adding a homepage
    updated_class['homepageUri'] = {
        'uri': 'https://developers.google.com/wallet',
        'description': 'Homepage description'
    }

    # Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
    updated_class['reviewStatus'] = 'UNDER_REVIEW'

    response = self.client.loyaltyclass().update(
        resourceId=f'{issuer_id}.{class_suffix}',
        body=updated_class).execute()

    print('Class update response')
    print(response)

    return f'{issuer_id}.{class_suffix}'

C#

Per avviare l'integrazione in C#, consulta le nostre di esempi di codice su GitHub.

/// <summary>
/// Update a class.
/// <para />
/// <strong>Warning:</strong> This replaces all existing class attributes!
/// </summary>
/// <param name="issuerId">The issuer ID being used for this request.</param>
/// <param name="classSuffix">Developer-defined unique ID for this pass class.</param>
/// <returns>The pass class ID: "{issuerId}.{classSuffix}"</returns>
public string UpdateClass(string issuerId, string classSuffix)
{
  // Check if the class exists
  Stream responseStream = service.Loyaltyclass
      .Get($"{issuerId}.{classSuffix}")
      .ExecuteAsStream();

  StreamReader responseReader = new StreamReader(responseStream);
  JObject jsonResponse = JObject.Parse(responseReader.ReadToEnd());

  if (jsonResponse.ContainsKey("error"))
  {
    if (jsonResponse["error"].Value<int>("code") == 404)
    {
      // Class does not exist
      Console.WriteLine($"Class {issuerId}.{classSuffix} not found!");
      return $"{issuerId}.{classSuffix}";
    }
    else
    {
      // Something else went wrong...
      Console.WriteLine(jsonResponse.ToString());
      return $"{issuerId}.{classSuffix}";
    }
  }

  // Class exists
  LoyaltyClass updatedClass = JsonConvert.DeserializeObject<LoyaltyClass>(jsonResponse.ToString());

  // Update the class by adding a homepage
  updatedClass.HomepageUri = new Google.Apis.Walletobjects.v1.Data.Uri
  {
    UriValue = "https://developers.google.com/wallet",
    Description = "Homepage description"
  };

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  updatedClass.ReviewStatus = "UNDER_REVIEW";

  responseStream = service.Loyaltyclass
      .Update(updatedClass, $"{issuerId}.{classSuffix}")
      .ExecuteAsStream();

  responseReader = new StreamReader(responseStream);
  jsonResponse = JObject.Parse(responseReader.ReadToEnd());

  Console.WriteLine("Class update response");
  Console.WriteLine(jsonResponse.ToString());

  return $"{issuerId}.{classSuffix}";
}

Node.js

Per avviare l'integrazione in Node, consulta le nostre di esempi di codice su GitHub.

/**
 * Update a class.
 *
 * **Warning:** This replaces all existing class attributes!
 *
 * @param {string} issuerId The issuer ID being used for this request.
 * @param {string} classSuffix Developer-defined unique ID for this pass class.
 *
 * @returns {string} The pass class ID: `${issuerId}.${classSuffix}`
 */
async updateClass(issuerId, classSuffix) {
  let response;

  // Check if the class exists
  try {
    response = await this.client.loyaltyclass.get({
      resourceId: `${issuerId}.${classSuffix}`
    });
  } catch (err) {
    if (err.response && err.response.status === 404) {
      console.log(`Class ${issuerId}.${classSuffix} not found!`);
      return `${issuerId}.${classSuffix}`;
    } else {
      // Something else went wrong...
      console.log(err);
      return `${issuerId}.${classSuffix}`;
    }
  }

  // Class exists
  let updatedClass = response.data;

  // Update the class by adding a homepage
  updatedClass['homepageUri'] = {
    'uri': 'https://developers.google.com/wallet',
    'description': 'Homepage description'
  };

  // Note: reviewStatus must be 'UNDER_REVIEW' or 'DRAFT' for updates
  updatedClass['reviewStatus'] = 'UNDER_REVIEW';

  response = await this.client.loyaltyclass.update({
    resourceId: `${issuerId}.${classSuffix}`,
    requestBody: updatedClass
  });

  console.log('Class update response');
  console.log(response);

  return `${issuerId}.${classSuffix}`;
}

Aggiorna un oggetto tessere

L'aggiornamento di un singolo LoyaltyObject interessa solo l'utente che è stato eseguito il provisioning dell'oggetto specifico. Dovresti aggiornare regolarmente le singole carte fedeltà per riflettere i cambiamenti che interessano i tuoi clienti e sono stati coinvolti. Il valore resourceId corrisponde all'ID oggetto (ISSUER_ID.OBJECT_SUFFIX).

# Update
PUT https://walletobjects.googleapis.com/walletobjects/v1/loyaltyobject/{resourceId}

# Patch
PATCH https://walletobjects.googleapis.com/walletobjects/v1/loyaltyobject/{resourceId}