rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگی‌های Merchant API، رفع اشکال‌ها و به‌روزرسانی‌ها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب می‌کند.
فیلتر محصولات
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
می‌توانید از جدول ProductView سرویس Reports برای نمایش یک نمای فیلتر شده از داده‌های محصول خود، از جمله وضعیت محصول استفاده کنید.
به عنوان مثال، می توانید برای انجام کارهای زیر از ProductView پرس و جو کنید:
- محصولاتی را که مشکل دارند فهرست کنید تا بتوانید آنها را حل کنید.
- فهرستی از محصولات جدید خود را دریافت کنید تا بتوانید خدمات را تأیید کنید.
برای مشاهده جزئیات کامل همه محصولات خود، از products.list استفاده کنید.
شما باید فیلد product_view.id را در بند SELECT درخواست خود وارد کنید. product_view.id همان مقدار REST ID محصول را دارد.
می توانید بر اساس تمام فیلدهای موجود به جز موارد زیر فیلتر کنید:
-
product_view.expiration_date -
product_view.item_issues
می توانید پاسخ را بر اساس تمام فیلدهای موجود به جز موارد زیر مرتب کنید:
-
product_view.gtin -
product_view.item_issues
برای مشاهده پتانسیل عملکرد محصولات خود می توانید از فیلدهای زیر استفاده کنید:
-
product_view.click_potential -
product_view.click_potential_rank
در اینجا یک مثال آورده شده است که تمام فیلدهای موجود برای محصولات شما را با وضعیت NOT_ELIGIBLE_OR_DISAPPROVED برمی گرداند. برای ارسال درخواست، عبارت Merchant Center Query Language زیر را به روش reports.search ارسال کنید:
SELECT
product_view.id,
product_view.offer_id,
product_view.title,
product_view.brand,
product_view.currency_code,
product_view.price_micros,
product_view.language_code,
product_view.condition,
product_view.channel,
product_view.availability,
product_view.shipping_label,
product_view.gtin,
product_view.item_group_id,
product_view.creation_time,
product_view.expiration_date,
product_view.aggregated_destination_status,
product_view.item_issues
product_view.click_potential
product_view.click_potential_rank
FROM ProductView
WHERE product_view.aggregated_destination_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'
اجرا کنید
روی Run کلیک کنید تا نمونه را در API Explorer امتحان کنید. بعد از اینکه روی Run کلیک کردید، مکان‌دار شناسه فروشنده را به شناسه فروشنده خود در URL درخواست به‌روزرسانی کنید. می توانید پرس و جو را اصلاح کنید. جستجوی کامل باید در یک خط باقی بماند تا با کاوشگر API کار کند.
برای اطلاعات بیشتر در مورد زمینه ها و رفتارهای خاص به مرجع ProductView مراجعه کنید.
برای یادگیری نحوه بازیابی داده‌های عملکرد محصولات خود با سرویس Reports ، به معیارهای عملکرد مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eProductView\u003c/code\u003e table within the \u003ccode\u003eReports\u003c/code\u003e service allows you to filter and view your product data, including statuses and performance potential.\u003c/p\u003e\n"],["\u003cp\u003eYou can query \u003ccode\u003eProductView\u003c/code\u003e to identify and resolve product issues, verify new product serving, and gain insights into click potential.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereports.search\u003c/code\u003e method, coupled with Merchant Center Query Language, enables you to retrieve specific product data based on your chosen criteria.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided resources for detailed information on \u003ccode\u003eProductView\u003c/code\u003e fields, performance metrics, and utilizing the \u003ccode\u003eReports\u003c/code\u003e service effectively.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. You can use the `ProductView` table within the `Reports` service to filter and view product data, including statuses, or list products with issues and new products. Queries must include the `product_view.id`. Filtering and sorting can be applied to most fields, excluding `product_view.expiration_date`, `product_view.item_issues`, and `product_view.gtin`. Performance potential can be viewed via `product_view.click_potential`.\n"],null,["# Filter products\n\nYou can use the\n[`ProductView`](/shopping-content/reference/rest/v2.1/reports/search#productview)\ntable of the `Reports` service to show a filtered view of your product data,\nincluding product statuses.\n\nFor example, you can query `ProductView` to do the following:\n\n- List products that have issues, so you can resolve them.\n- Get a list of your new products, so you can verify serving.\n\nTo view full details of all your products, use\n[`products.list`](/shopping-content/reference/rest/v2.1/products/list).\n\nYou must include the `product_view.id` field in the `SELECT` clause of your\nquery. The `product_view.id` has the same value as the product's [REST\nID](/shopping-content/guides/products/product-id).\n\nYou can filter based on all the [available\nfields](/shopping-content/reference/rest/v2.1/reports/search#productview) except the following:\n\n- `product_view.expiration_date`\n- `product_view.item_issues`\n\nYou can sort the response based on all the available fields except the following:\n\n- `product_view.gtin`\n- `product_view.item_issues`\n\nYou can use the following fields to view the performance potential of your\nproducts:\n\n- `product_view.click_potential`\n- `product_view.click_potential_rank`\n\nHere's an example that returns all the available fields for your products with\nthe status `NOT_ELIGIBLE_OR_DISAPPROVED`. To make the request, pass the\nfollowing Merchant Center Query Language statement to the\n[`reports.search`](/shopping-content/reference/rest/v2.1/reports/search)\nmethod: \n\n SELECT\n product_view.id,\n product_view.offer_id,\n product_view.title,\n product_view.brand,\n product_view.currency_code,\n product_view.price_micros,\n product_view.language_code,\n product_view.condition,\n product_view.channel,\n product_view.availability,\n product_view.shipping_label,\n product_view.gtin,\n product_view.item_group_id,\n product_view.creation_time,\n product_view.expiration_date,\n product_view.aggregated_destination_status,\n product_view.item_issues\n product_view.click_potential\n product_view.click_potential_rank\n FROM ProductView\n WHERE product_view.aggregated_destination_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'\n\n[Run](https://developers.google.com/shopping-content/reference/rest/v2.1/reports/search?apix=true&apix_params=%7B%22merchantId%22%3A0%2C%22resource%22%3A%7B%22query%22%3A%22SELECT%20%20product_view.id%2C%20%20product_view.offer_id%2C%20%20product_view.title%2C%20%20product_view.brand%2C%20%20product_view.currency_code%2C%20%20product_view.price_micros%2C%20%20product_view.language_code%2C%20%20product_view.condition%2C%20%20product_view.channel%2C%20%20product_view.availability%2C%20%20product_view.shipping_label%2C%20%20product_view.gtin%2C%20%20product_view.item_group_id%2C%20%20product_view.creation_time%2C%20%20product_view.expiration_date%2C%20%20product_view.aggregated_destination_status%2C%20%20product_view.item_issues%20FROM%20ProductView%20WHERE%20product_view.aggregated_destination_status%20%3D%20%27NOT_ELIGIBLE_OR_DISAPPROVED%27%22%7D%7D)\n\nClick **Run** to try the sample in the **API Explorer** . After you click\n**Run** , update the merchant ID placeholder to your own merchant ID in the\nrequest URL. You can modify the query. The full query must remain on one line to\nwork with the **API explorer**.\n\nSee the [`ProductView`](/shopping-content/reference/rest/v2.1/reports/search#productview) reference for\nmore information on specific fields and behavior.\n\nSee [Performance metrics](/shopping-content/guides/reports/metrics) to learn how\nto retrieve performance data for your products with the `Reports` service."]]
