این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

ایجاد کلاس های پاس و اشیاء پاس

تقریباً تمام مجوزهایی که می‌توانید برای کاربر نهایی صادر کنید تا در کیف پول Google خود ذخیره کند، توسط دو جزء تعریف می‌شوند: یک کلاس پاس و یک شی پاس. هر زمان که برای یک کاربر مجوز صادر می‌کنید، به نمونه‌ای از یک Passes Class و یک Object Passes نیاز خواهید داشت که به API Google Wallet می‌گوید چه نوع پاسی را باید بسازد، و همچنین جزئیاتی را برای نمایش در مجوز، مانند ارزش کارت هدیه یا نام دارنده بلیط

Google Wallet API مجموعه ای از پیش تعریف شده از Pass Class ها و Passes Objects را ارائه می دهد که نمونه هایی از آنها را ایجاد می کنید، سپس برای ایجاد مجوزی که برای یک کاربر صادر می شود، مانند GiftCardClass و GiftCardObject ، GenericClass و GenericObject ، و موارد دیگر استفاده می کنید.

هر نمونه Passes Class و Passes Object به عنوان یک شی JSON تعریف می‌شود که دارای مجموعه‌ای از ویژگی‌های مورد نیاز و اختیاری است که مطابق با مورد استفاده خاص در نظر گرفته شده برای آن نوع پاس است.

یک کلاس پاس ایجاد کنید

یک کلاس پاس را می توان به عنوان یک الگوی مشترک در نظر گرفت که پاس ها از آن ایجاد می شوند. یک کلاس Passes ویژگی‌های خاصی را تعریف می‌کند که در همه پاس‌هایی که از آن استفاده می‌کنند گنجانده می‌شوند. یک صادرکننده مجوز می‌تواند چندین کلاس ایجاد کند، که هر کدام مجموعه‌ای از ویژگی‌های خاص خود را دارند که ویژگی‌هایی مانند سبک و ظاهر و همچنین ویژگی‌های اضافی مانند Smart Tap و ثبت نام و ورود به سیستم را تعریف می‌کنند.

کلاس‌های پاس ممکن است با استفاده از Google Wallet REST API، Google Wallet Android SDK یا در Google Wallet Business Console ایجاد شوند.

برای کاربران جدید، Business Console ساده‌ترین راه برای شروع کار با ایجاد کلاس Passes است، زیرا یک رابط کاربری ساده را فراهم می‌کند، جایی که می‌توانید با پر کردن فیلدهای فرم، فیلدهای مختلف اولین کلاس پاس خود را تعریف کنید.

برای کاربران پیشرفته، ایجاد Pass Classes به صورت برنامه نویسی بهترین رویکرد است.

از Google Wallet Business Console استفاده کنید

برای ایجاد یک کلاس پاس در کنسول کسب و کار Google Wallet، موارد زیر را انجام دهید:

به Google Pay and Wallet Business Console بروید و با حساب صادرکننده API Google Wallet خود وارد شوید.
در کارت «Google Wallet API»، روی دکمه «Manage passes» کلیک کنید.
در بخش «دسترسی به انتشار»، روی دکمه «ایجاد کلاس» کلیک کنید.
یک نوع پاس را از گفتگو انتخاب کنید. Google Wallet انواع مختلف مجوز (بلیت رویداد، پیشنهاد، کارت وفاداری و غیره) را ارائه می دهد. برای استفاده انعطاف پذیر، «Generic» را به عنوان نوع پاس خود انتخاب کنید.
مقادیر مناسب فیلدهای مورد نیاز را پر کنید.
برای ذخیره کلاس خود روی دکمه "ایجاد کلاس" کلیک کنید.

از Google Wallet REST API استفاده کنید

برای ایجاد یک کلاس عبور با استفاده از Google Wallet REST API، یک درخواست POST به https://walletobjects.googleapis.com/walletobjects/v1/eventTicketClass ارسال کنید. برای اطلاعات بیشتر، به مستندات مرجع مراجعه کنید.

جاوا

برای شروع ادغام خود در جاوا، به نمونه کدهای کامل ما در 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.eventticketclass().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/tickets/events/rest/v1/eventticketclass
  EventTicketClass newClass =
      new EventTicketClass()
          .setEventId(String.format("%s.%s", issuerId, classSuffix))
          .setEventName(
              new LocalizedString()
                  .setDefaultValue(
                      new TranslatedString().setLanguage("en-US").setValue("Event name")))
          .setId(String.format("%s.%s", issuerId, classSuffix))
          .setIssuerName("Issuer name")
          .setReviewStatus("UNDER_REVIEW");

  EventTicketClass response = service.eventticketclass().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->eventticketclass->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/tickets/events/rest/v1/eventticketclass
  $newClass = new EventTicketClass([
    'eventId' => "{$issuerId}.{$classSuffix}",
    'eventName' => new LocalizedString([
      'defaultValue' => new TranslatedString([
        'language' => 'en-US',
        'value' => 'Event name'
      ])
    ]),
    'id' => "{$issuerId}.{$classSuffix}",
    'issuerName' => 'Issuer name',
    'reviewStatus' => 'UNDER_REVIEW'
  ]);

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

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

  return $response->id;
}

پایتون

برای شروع ادغام خود در پایتون، به نمونه کدهای کامل ما در 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.eventticketclass().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/tickets/events/rest/v1/eventticketclass
    new_class = {
        'eventId': f'{issuer_id}.{class_suffix}',
        'eventName': {
            'defaultValue': {
                'language': 'en-US',
                'value': 'Event name'
            }
        },
        'id': f'{issuer_id}.{class_suffix}',
        'issuerName': 'Issuer name',
        'reviewStatus': 'UNDER_REVIEW'
    }

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

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

    return f'{issuer_id}.{class_suffix}'

سی شارپ

برای شروع ادغام خود در 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.Eventticketclass
      .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/tickets/events/rest/v1/eventticketclass
  EventTicketClass newClass = new EventTicketClass
  {
    EventId = $"{issuerId}.{classSuffix}",
    EventName = new LocalizedString
    {
      DefaultValue = new TranslatedString
      {
        Language = "en-US",
        Value = "Event name"
      }
    },
    Id = $"{issuerId}.{classSuffix}",
    IssuerName = "Issuer name",
    ReviewStatus = "UNDER_REVIEW"
  };

  responseStream = service.Eventticketclass
      .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.eventticketclass.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/tickets/events/rest/v1/eventticketclass
  let newClass = {
    'eventId': `${issuerId}.${classSuffix}`,
    'eventName': {
      'defaultValue': {
        'language': 'en-US',
        'value': 'Event name'
      }
    },
    'id': `${issuerId}.${classSuffix}`,
    'issuerName': 'Issuer name',
    'reviewStatus': 'UNDER_REVIEW'
  };

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

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

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

برو

برای شروع ادغام خود در Go، به نمونه کدهای کامل ما در نمونه کدهای GitHub در Github مراجعه کنید.

// Create a class.
func (d *demoEventticket) createClass(issuerId, classSuffix string) {
	eventticketClass := new(walletobjects.EventTicketClass)
	eventticketClass.Id = fmt.Sprintf("%s.%s", issuerId, classSuffix)
	eventticketClass.EventName = &walletobjects.LocalizedString{
		DefaultValue: &walletobjects.TranslatedString{
			Language: "en-us",
			Value:    "Event name",
		},
	}
	eventticketClass.IssuerName = "Issuer name"
	eventticketClass.ReviewStatus = "UNDER_REVIEW"
	res, err := d.service.Eventticketclass.Insert(eventticketClass).Do()
	if err != nil {
		log.Fatalf("Unable to insert class: %v", err)
	} else {
		fmt.Printf("Class insert id:\n%v\n", res.Id)
	}
}

یک شی Passes ایجاد کنید

یک شیء عبور نمونه ای از یک کلاس پاس است. برای ایجاد یک Object Passes، باید ویژگی های زیر را ارائه دهید:

classId : id کلاس Passes

id : یک شناسه منحصر به فرد برای مشتری شما

برای اطلاعات بیشتر در مورد نحوه نمایش این ویژگی ها در بلیط رویداد به الگوی Layout مراجعه کنید.

نمونه کد برای ایجاد یک Object Passes: