Ürün durumları

Kuruluşunuzun ayrıntılı durumunu görüntülemek için Product kaynağını kullanabilirsiniz. Alışveriş ürünleri.

Content API ile ProductStatuses.get yöntemini çağırın. Merchant API ile ürünü, durumu (Accounts.Products kaynağını alarak) kontrol edin.

Alışveriş ads ve ücretsiz girişleriyle ilgili tüm politikaları ihlal eder. Alışveriş reklamları kullanmamız halinde bu politikaları uygulama ve uygun şekilde yanıt verme hakkını saklı tutar. bu politikaları ihlal eden içerik veya davranışları tespit etme.

Şartlar

Ürün durumlarını görmek için aşağıdakileri yapmanız gerekir:

• Hesabınızı bir hedefe kaydedin.
• Aşağıdakilerden birinde geçerli bir ülke kodu girin:
  • feedLabel alanı.
  • shipping alanı.
  • Feed düzeyinde.
  • Hesabınızın kargo ayarları.

Bir ürünün durumunu öğrenme

Bir ürünün durumunu görüntülemek için Accounts.Products kaynağını alın.

Aşağıda örnek bir GET isteği verilmiştir:

GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}

products.get adlı kullanıcının tüm yanıtları aşağıdaki alanları içerir:

• creationDate: Ürünün oluşturulduğu tarih.
• lastUpdateDate: Ürünün son güncellendiği zaman.
• googleExpirationDate: Ürünün süresinin dolacağı tarih.
• destinationStatuses: Ürünün amaçlanan hedefleri.
• itemLevelIssues: Ürünle ilişkili tüm sorunların listesi.

Yanıtta itemLevelIssues alanını yalnızca aşağıdaki durumlarda görürsünüz: öğe düzeyinde sorunlar olduğunu fark ettiniz.

Aşağıda örnek bir JSON yanıtı verilmiştir:

{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
  "title": "Color Headphones",
  "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
  "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
  "availability": "in stock",
  "brand": "Google",
  "condition": "new",
  "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
  "gtin": "00050644632143",
  "mpn": "90000007101",
  "price": {
    "amountMicros": "288000",
    "currencyCode": "USD"
  }
},
"productStatus": {
  "destinationStatuses": [
    {
      "reportingContext": "FREE_LISTINGS",
      "disapprovedCountries": [
        "US"
      ]
    }
  ],
  "itemLevelIssues": [
    {
      "code": "pending_phone_verification",
      "severity": "NOT_IMPACTED",
      "resolution": "merchant_action",
      "reportingContext": "FREE_LISTINGS",
      "description": "Unverified phone number",
      "detail": "Go to the Business information page to verify your business phone number",
      "documentation": "https://support.google.com/merchants/answer/10139041",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "pending_initial_policy_review_free_listings",
      "severity": "DISAPPROVED",
      "resolution": "pending_processing",
      "reportingContext": "FREE_LISTINGS",
      "description": "Pending initial review",
      "detail": "Please wait up to 3 business days for the review to be completed",
      "documentation": "https://support.google.com/merchants/answer/2948694",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "url_does_not_match_homepage",
      "severity": "DISAPPROVED",
      "resolution": "merchant_action",
      "attribute": "link",
      "reportingContext": "FREE_LISTINGS",
      "description": "Mismatched domains [link]",
      "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
      "documentation": "https://support.google.com/merchants/answer/160050",
      "applicableCountries": [
        "US"
      ]
    }
  ],
  "creationDate": "2024-05-27T16:15:31.791730Z",
  "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
  "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}

Tüm ürün durumlarını listele

Tüm ürünlerinizi ve durumlarını görmek için products.list kullanın.

Sorgunuzu daraltmak için aşağıdaki parametreleri kullanabilirsiniz:

• pageToken: Sonraki sonuç sayfalarını almak için kullanılır. Her sayfada bir Sıralamada bir sonraki sayfaya geçmek için kullanabileceğiniz nextPageToken.
• maxResults: Sayfa başına maksimum sonuç sayısı.

Aşağıda, isteğe bağlı sorgu parametreleri içeren örnek bir list isteği verilmiştir:

GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9

Aşağıda örnek bir JSON yanıtı verilmiştir:

{
"nextPageToken": "632fd090c95712c6",
"products": [
 {
  "name": "accounts/123/products/online~en~US~1",
  "channel": "ONLINE",
  "offerId": "1",
  "contentLanguage": "en",
  "feedLabel": "US",
  "dataSource": "accounts/123/dataSources/10355371287",
  "attributes": {
    "title": "Color Headphones",
    "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
    "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
    "availability": "in stock",
    "brand": "Google",
    "condition": "new",
    "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
    "gtin": "00050644632143",
    "mpn": "90000007101",
    "price": {
      "amountMicros": "28800000",
      "currencyCode": "USD"
    }
  },
  "productStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "disapprovedCountries": [
          "US"
        ]
      }
    ],
    "itemLevelIssues": [
      {
        "code": "pending_phone_verification",
        "severity": "NOT_IMPACTED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unverified phone number",
        "detail": "Go to the Business information page to verify your business phone number",
        "documentation": "https://support.google.com/merchants/answer/10139041",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "pending_initial_policy_review_free_listings",
        "severity": "DISAPPROVED",
        "resolution": "pending_processing",
        "reportingContext": "FREE_LISTINGS",
        "description": "Pending initial review",
        "detail": "Please wait up to 3 business days for the review to be completed",
        "documentation": "https://support.google.com/merchants/answer/2948694",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "url_does_not_match_homepage",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "attribute": "link",
        "reportingContext": "FREE_LISTINGS",
        "description": "Mismatched domains [link]",
        "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
        "documentation": "https://support.google.com/merchants/answer/160050",
        "applicableCountries": [
          "US"
        ]
      }
    ],
    "creationDate": "2024-05-27T16:15:31.791730Z",
    "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
    "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
  }
]
}

productstatuses.list çağrısını üretimde test etmek güvenlidir, çünkü verilerinizde değişiklik yapın.

Öğe düzeyindeki sorunlar

Öğe düzeyindeki her sorun aşağıdaki alanları içerir:

• code: Sorunun hata kodu.
• severity: Sorunun önem derecesi.
• resolution: Satıcının sorunu çözüp çözemeyeceğini bildirir.
• attribute: Etkilenen özellik adı.
• reportingContext: Sorunun geçerli olduğu raporlama bağlamı.
• description: Sorunun açıklaması.
• detail: Sorunla ilgili daha fazla bilgi verir.
• documentation: Sorunla ilgili dokümanların URL'si.
• applicableCountries: Sorunun hangi ülkelerde etkili olduğunu belirtir. belirler.