דף זה תורגם על ידי Cloud Translation API.

יצירת אובייקטים של מחלקות ואישורים של כרטיסים

כמעט כל הכרטיסים שאפשר להנפיק למשתמש קצה לשמור ב-Google Wallet מוגדרים על ידי שני רכיבים: מחלקת כרטיסים ואובייקט כרטיסים. בכל פעם שמנפיקים כרטיס למשתמש, יהיה צורך במופע של מחלקת כרטיסים ואובייקט כרטיסים. האובייקט הזה מציין ל-Google Wallet API את סוג הכרטיס שצריך לבנות וגם פרטים שיוצגו בכרטיס, כמו השווי של כרטיס המתנה או השם של בעל הכרטיס.

Google Wallet API מספק קבוצה מוגדרת מראש של אובייקטים מסוג מחלקות וכרטיסים של כרטיסים שאפשר ליצור עבורם מופעים, ולהשתמש בהם כדי ליצור כרטיס שמונפק למשתמש כמו GiftCardClass וגם GiftCardObject, GenericClass ו-GenericObject ועוד.

כל מופע של Passes Class ו-Passes Object מוגדר כאובייקט JSON, שיש בו קבוצה של מאפיינים נדרשים ואופציונליים שתואמים לתרחיש לדוגמה הספציפי שמיועד לסוג הכרטיס הזה.

יצירת מחלקת כרטיסים

אפשר להתייחס לסוג כרטיסים כאל תבנית משותפת שממנה נוצרים כרטיסים. סיווג כרטיסים מגדיר מאפיינים מסוימים שייכללו בכל הכרטיסים שמשתמשים בו. מנפיק כרטיסים יכול ליצור מספר מחלקות, לכל אחת מהן יש קבוצה ייחודית של מאפיינים שמגדירה מאפיינים כמו סגנון ומראה, וכן תכונות נוספות כמו 'הקשה חכמה', וכן את ההרשמה והכניסה.

ניתן ליצור מחלקות של כרטיסים באמצעות Google Wallet API ל-REST , Google Wallet Android SDK או במסוף העסקי של Google Wallet.

עבור משתמשים חדשים, המסוף העסקי הוא הדרך הקלה ביותר להתחיל ליצור מחלקת כרטיסים. מאחר שהוא מספק ממשק משתמש פשוט, שבו אפשר להגדיר את השדות השונים של כיתת הכרטיסים הראשונה על ידי מילוי שדות של טפסים.

למשתמשים מתקדמים, מומלץ ליצור כיתות כרטיסים באופן פרוגרמטי.

השתמש במסוף העסקי של Google Wallet

כדי ליצור מחלקת כרטיסים במסוף העסקי של Google Wallet, יש לבצע את הפעולות הבאות:

עבור אל המסוף העסקי של Google Pay ו-Wallet והיכנס באמצעות החשבון של מנפיק ה-API של Google Wallet.
בכרטיס Google Wallet API, לוחצים על הלחצן 'ניהול הכרטיסים'.
בקטע 'קבלת גישה לפרסום', לוחצים על הלחצן 'יצירת כיתה'.
בוחרים את סוג הכרטיס מתיבת הדו-שיח. ב-Google Wallet יש סוגים שונים של כרטיסים (כרטיס לאירוע, מבצע, כרטיס מועדון לקוחות וכו'). בתרחיש לדוגמה גמיש, בוחרים באפשרות 'כללי' כסוג הכרטיס.
ממלאים את הערכים המתאימים בשדות החובה.
יש ללחוץ על הלחצן 'יצירת כיתה' כדי לשמור את הכיתה.

שימוש ב-API ל-REST של Google Wallet

כדי ליצור מחלקת כרטיסים באמצעות Google Wallet API ל-REST, צריך לשלוח בקשת POST אל https://walletobjects.googleapis.com/walletobjects/v1/giftCardClass. מידע נוסף זמין במסמכי התיעוד.

Java

כדי להתחיל בשילוב ב-Java, עיינו ב דוגמאות הקוד המלאות ב-GitHub.

/**
 * Create a class.
 *
 * @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 createClass(String issuerId, String classSuffix) throws IOException {
  // Check if the class exists
  try {
    service.giftcardclass().get(String.format("%s.%s", issuerId, classSuffix)).execute();

    System.out.printf("Class %s.%s already exists!%n", issuerId, classSuffix);
    return String.format("%s.%s", issuerId, classSuffix);
  } catch (GoogleJsonResponseException ex) {
    if (ex.getStatusCode() != 404) {
      // Something else went wrong...
      ex.printStackTrace();
      return String.format("%s.%s", issuerId, classSuffix);
    }
  }

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/gift-cards/rest/v1/giftcardclass
  GiftCardClass newClass =
      new GiftCardClass()
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW");

  GiftCardClass response = service.giftcardclass().insert(newClass).execute();

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

  return response.getId();
}

PHP

כדי להתחיל בשילוב ב-PHP, עיינו ב דוגמאות הקוד המלאות ב-GitHub.

/**
 * Create a class.
 *
 * @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 createClass(string $issuerId, string $classSuffix)
{
  // Check if the class exists
  try {
    $this->service->giftcardclass->get("{$issuerId}.{$classSuffix}");

    print("Class {$issuerId}.{$classSuffix} already exists!");
    return "{$issuerId}.{$classSuffix}";
  } catch (Google\Service\Exception $ex) {
    if (empty($ex->getErrors()) || $ex->getErrors()[0]['reason'] != 'classNotFound') {
      // Something else went wrong...
      print_r($ex);
      return "{$issuerId}.{$classSuffix}";
    }
  }

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/gift-cards/rest/v1/giftcardclass
  $newClass = new GiftCardClass([
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW'
  ]);

  $response = $this->service->giftcardclass->insert($newClass);

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

  return $response->id;
}

Python

כדי להתחיל בשילוב עם Python, עיינו ב דוגמאות הקוד המלאות ב-GitHub.

def create_class(self, issuer_id: str, class_suffix: str) -> str:
    """Create a class.

    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:
        self.client.giftcardclass().get(resourceId=f'{issuer_id}.{class_suffix}').execute()
    except HttpError as e:
        if e.status_code != 404:
            # Something else went wrong...
            print(e.error_details)
            return f'{issuer_id}.{class_suffix}'
    else:
        print(f'Class {issuer_id}.{class_suffix} already exists!')
        return f'{issuer_id}.{class_suffix}'

    # See link below for more information on required properties
    # https://developers.google.com/wallet/retail/gift-cards/rest/v1/giftcardclass
    new_class = {
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW'
    }

    response = self.client.giftcardclass().insert(body=new_class).execute()

    print('Class insert response')
    print(response)

    return f'{issuer_id}.{class_suffix}'

C#

כדי להתחיל את השילוב ב-C#, עיינו ב דוגמאות הקוד המלאות ב-GitHub.

/// <summary>
/// Create a class.
/// </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 CreateClass(string issuerId, string classSuffix)
{
  // Check if the class exists
  Stream responseStream = service.Giftcardclass
      .Get($"{issuerId}.{classSuffix}")
      .ExecuteAsStream();

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

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

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/gift-cards/rest/v1/giftcardclass
  GiftCardClass newClass = new GiftCardClass
  {
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW"
  };

  responseStream = service.Giftcardclass
      .Insert(newClass)
      .ExecuteAsStream();

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

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

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

Node.js

כדי להתחיל את השילוב ב-Node, אפשר לעיין ב דוגמאות הקוד המלאות ב-GitHub.

/**
 * Create a class.
 *
 * @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 createClass(issuerId, classSuffix) {
  let response;

  // Check if the class exists
  try {
    response = await this.client.giftcardclass.get({
      resourceId: `${issuerId}.${classSuffix}`
    });

    console.log(`Class ${issuerId}.${classSuffix} already exists!`);

    return `${issuerId}.${classSuffix}`;
  } catch (err) {
    if (err.response && err.response.status !== 404) {
      // Something else went wrong...
      console.log(err);
      return `${issuerId}.${classSuffix}`;
    }
  }

  // See link below for more information on required properties
  // https://developers.google.com/wallet/retail/gift-cards/rest/v1/giftcardclass
  let newClass = {
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW',
  };

  response = await this.client.giftcardclass.insert({
    requestBody: newClass
  });

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

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

Go

כדי להתחיל בשילוב ב-Go, אפשר לעיין בדוגמאות הקוד המלאות שלנו ב דוגמאות הקוד ב-GitHub.

// Create a class.
func (d *demoGiftcard) createClass(issuerId, classSuffix string) {
	giftcardClass := new(walletobjects.GiftCardClass)
	giftcardClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	giftcardClass.IssuerName = "Issuer name"
	giftcardClass.ReviewStatus = "UNDER_REVIEW"
	res, err := d.service.Giftcardclass.Insert(giftcardClass).Do()
	if err != nil {
		log.Fatalf("Unable to insert class: %v", err)
	} else {
		fmt.Printf("Class insert id:\n%v\n", res.Id)
	}
}

יצירת אובייקט של כרטיסים

אובייקט של כרטיסים הוא מופע של מחלקה של כרטיסים. כדי ליצור אובייקט 'כרטיסים', יש לספק את המאפיינים הבאים:

classId: id של מחלקת הכרטיסים

id: מזהה ייחודי של הלקוח

תוכלו להיעזר בתבנית הפריסה כדי לקבל מידע נוסף על האופן שבו המאפיינים האלה מיוצגים בכרטיס המתנה.

דוגמת קוד ליצירת אובייקט 'כרטיסים':