オークション

Q&A取得

リクエストURL
XML
http://auctions.yahooapis.jp/AuctionWebService/V1/ShowQandA

出品者に対する質問と回答を表示する機能を提供します。

リクエストパラメータ

RESTリクエストの構築(GET)」および、「RESTリクエストの構築(POST)」をご参照ください。

パラメータ 説明
appid(必須) string アプリケーションID。詳細はこちらをご覧ください。
output string XML、PHPserialize、JSONPでレスポンスの出し別けを行います。
  • xml :xmlレスポンス(デフォルト)
  • php :PHPserializeレスポンス
  • json :JSONPレスポンス
callback string JSONPとして出力する際のコールバック関数名を入力するためのパラメータです。UTF-8でエンコードした文字列を入力します。
auctionID(必須) string 質問を参照する商品を特定するオークションIDです。

サンプルリクエストURL

http://auctions.yahooapis.jp/AuctionWebService/V1/ShowQandA?appid=<あなたのアプリケーションID>&auctionID=<商品(オークション)のID>


レスポンスフィールド

Q&A取得APIのスキーマの記述は、以下になります。

フィールド 説明
/ResultSet クエリーレスポンスのすべてを含みます。
  • totalResultsAvailable: 質問の総個数です。
  • totalResultsReturned: 返された値の個数です。
  • firstResultPosition: 最初のデータが何個目にあたるかです。
/ResultSet/Result 各個別レスポンスを含みます。
  • totalQandAAvailable: QandAフィールドの出現数を表します。
/ResultSet/Result/AuctionID レスポンスの対象となっているオークションのオークションIDです。
/ResultSet/Result/AuctionURL 該当オークションの商品詳細を取得するリクエストURLです。(appidは含まれていませんのでご注意ください)
/ResultSet/Result/StartTime 該当オークションの開始日時です。UNIXTIME表記で表現します。(例:1440514800)
/ResultSet/Result/QandA 各個別レスポンスを含みます。
/ResultSet/Result/QandA/Title 質問番号を含むタイトルです。(例:質問1)
/ResultSet/Result/QandA/WhichQuestion 質問IDです。
/ResultSet/Result/QandA/Question 質問フィールドです。
/ResultSet/Result/QandA/Question/Comment 質問内容です。(例:同こんは可能でしょうか?)
/ResultSet/Result/QandA/Question/Date 質問日時です。RFC3339に準拠した表現を用います。(例:2004-04-01T12:00:00+09:00)
/ResultSet/Result/QandA/Question/Id 質問投稿者のYahoo! JAPAN IDです。
/ResultSet/Result/QandA/Question/Rating 評価を表現するフィールドです。
/ResultSet/Result/QandA/Question/Rating/Point 評価ポイントです。新規の際には0を設定します。
/ResultSet/Result/QandA/Question/Rating/IsSuspended 停止中の際、trueとなります。
/ResultSet/Result/QandA/Question/Rating/IsDeleted 登録削除済みの際、trueとなります。
/ResultSet/Result/QandA/Question/RatingURL 質問投稿者の評価一覧を取得するリクエストURLです。(appidは含まれていませんのでご注意ください)
/ResultSet/Result/QandA/Question/ItemListURL 質問者の出品リストを取得するリクエストURLです。(appidは含まれていませんのでご注意ください)
/ResultSet/Result/QandA/Answer 回答フィールドです。
/ResultSet/Result/QandA/Answer/Comment 回答内容です。(例:同こん可能です。)
/ResultSet/Result/QandA/Answer/Date 回答日時です。RFC3339に準拠した表現を用います。(例:2004-04-01T12:00:00+09:00)
/ResultSet/Result/QandA/Answer/Id 回答者(出品者)のYahoo! JAPAN IDです。
/ResultSet/Result/QandA/Answer/Rating 回答者(出品者)の評価ポイントです。
/ResultSet/Result/QandA/Answer/Rating/Point 評価ポイントです。新規の際には0を設定します。
/ResultSet/Result/QandA/Answer/Rating/IsSuspended 停止中の際、trueとなります。
/ResultSet/Result/QandA/Answer/Rating/IsDeleted 登録削除済みの際、trueとなります。
/ResultSet/Result/QandA/Answer/RatingURL 回答者(出品者)の評価リストを取得するリクエストURLです。(appidは含まれていませんのでご注意ください)。
/ResultSet/Result/QandA/Answer/ItemListURL 回答者(出品者)の出品リストを取得するリクエストURLです。(appidは含まれていませんのでご注意ください)。



サンプルレスポンス

<ResultSet totalResultsAvailable="2" totalResultsReturned="2" firstResultPosition="2">
  <Result totalQandAAvailable="2">
    <AuctionID>a123456789</AuctionID>
    <AuctionURL>http://auctions.yahooapis.jp/AuctionWebService/V1/AuctionItem?auctionID=a123456789 </AuctionURL>
    <StartTime>1440514800<StartTime>
    <QandA>
      <Title>質問2</Title>
      <WhichQuestion>2</WhichQuestion>
      <Question>
        <Comment>質問の者です。ご検討よろしくお願い致します。</Comment>
        <Date>2013-02-20T15:12:05+09:00</Date>
        <Id>tia*****</Id>
        <Rating>
          <Point>1470</Point>
          <IsSuspended>false</IsSuspended>
          <IsDeleted>false</IsDeleted>
        </Rating>
      </Question>
      <Answer>
        <Comment>恐れ入りますが即決価格を提示してますのでこの値段でお取引願います。よろしくお願いします </Comment>
        <Date>2013-02-22T01:33:59+09:00</Date>
        <Id>abcdef</Id>
        <Rating>
          <Point>4573</Point>
          <IsSuspended>false</IsSuspended>
          <IsDeleted>false</IsDeleted>
        </Rating>
        <RatingURL>http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef </RatingURL>
        <ItemListURL>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=abcdef </ItemListURL>
      </Answer>
    </QandA>
    <QandA>
      <Title>質問3</Title>
      <WhichQuestion>3</WhichQuestion>
      <Question>
        <Comment>ご検討いただけたらと思います。よろしくお願い致します。 </Comment>
        <Date>2013-02-25T17:16:07+09:00</Date>
        <Id>tia*****</Id>
        <Rating>
          <Point>1470</Point>
          <IsSuspended>false</IsSuspended>
          <IsDeleted>false</IsDeleted>
        </Rating>
      </Question>
      <Answer>
        <Comment>何度も検討頂きありがとうございます。申し訳ありませんが即決価格は下げる予定はありません。よろしくお願いします </Comment>
        <Date>2013-02-25T18:46:43+09:00</Date>
        <Id>abcdef</Id>
        <Rating>
          <Point>4573</Point>
          <IsSuspended>false</IsSuspended>
          <IsDeleted>false</IsDeleted>
        </Rating>
        <RatingURL>http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef </RatingURL>
        <ItemListURL>http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=abcdef </ItemListURL>
      </Answer>
    </QandA>
  </Result>
</ResultSet>

サンプルレスポンス(PHPserialize)

a: 1: {
  s: 9: "ResultSet";
  a: 4: {
    s: 21: "totalResultsAvailable";
    s: 1: "2";
    s: 20: "totalResultsReturned";
    s: 1: "2";
    s: 19: "firstResultPosition";
    s: 1: "2";
    s: 6: "Result";
    a: 4: {
      s: 9: "AuctionID";
      s: 10: "a123456789";
      s: 10: "AuctionURL";
      s: 82: "http://auctions.yahooapis.jp/AuctionWebService/V1/AuctionItem?auctionID=a123456789";
      s: 9: "StartTime";
      s: 10: "1440514800";
      s: 5: "QandA";
      a: 2: {
        i: 0;
        a: 4: {
          s: 5: "Title";
          s: 7: "質問2";
          s: 13: "WhichQuestion";
          s: 1: "2";
          s: 8: "Question";
          a: 4: {
            s: 7: "Comment";
            s: 116: "質問の者です。ご返答、ご検討よろしくお願い致します。";
            s: 4: "Date";
            s: 30: "
2013-02-20T15:12:05+09:00				";
            s: 2: "Id";
            s: 8: "tia*****";
            s: 6: "Rating";
            a: 3: {
              s: 5: "Point";
              s: 4: "1470";
              s: 11: "IsSuspended";
              b: 0;
              s: 9: "IsDeleted";
              b: 0;
            }
          }
          s: 6: "Answer";
          a: 6: {
            s: 7: "Comment";
            s: 195: "恐れ入りますが即決価格を提示してますのでこの値段でお取引願います。よろしくお願いします";
            s: 4: "Date";
            s: 30: "
2013-02-22T01:33:59+09:00				";
            s: 2: "Id";
            s: 12: "abcdef";
            s: 6: "Rating";
            a: 3: {
              s: 5: "Point";
              s: 4: "4573";
              s: 11: "IsSuspended";
              b: 0;
              s: 9: "IsDeleted";
              b: 0;
            }
            s: 9: "RatingURL";
            s: 76: "http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef";
            s: 11: "ItemListURL";
            s: 83: "http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=abcdef";
          }
        }
        i: 1;
        a: 4: {
          s: 5: "Title";
          s: 7: "質問3";
          s: 13: "WhichQuestion";
          s: 1: "3";
          s: 8: "Question";
          a: 4: {
            s: 7: "Comment";
            s: 245: "何度か繰り返しの出品と思いご検討いただけたらと思います。よろしくお願い致します。";
            s: 4: "Date";
            s: 30: "
2013-02-25T17:16:07+09:00				";
            s: 2: "Id";
            s: 8: "tia*****";
            s: 6: "Rating";
            a: 3: {
              s: 5: "Point";
              s: 4: "1470";
              s: 11: "IsSuspended";
              b: 0;
              s: 9: "IsDeleted";
              b: 0;
            }
          }
          s: 6: "Answer";
          a: 6: {
            s: 7: "Comment";
            s: 279: "ご検討下さい。よろしくお願いします";
            s: 4: "Date";
            s: 30: "
2013-02-25T18:46:43+09:00				";
            s: 2: "Id";
            s: 12: "abcdef";
            s: 6: "Rating";
            a: 3: {
              s: 5: "Point";
              s: 4: "4573";
              s: 11: "IsSuspended";
              b: 0;
              s: 9: "IsDeleted";
              b: 0;
            }
            s: 9: "RatingURL";
            s: 76: "http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef";
            s: 11: "ItemListURL";
            s: 83: "http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=abcdef";
          }
        }
      }
      s: 19: "totalQandAAvailable";
      s: 1: "2";
    }
  }
}

サンプルレスポンス(JSONP)

loaded({
  ResultSet: {@attributes: {
      totalResultsAvailable: "2",
      totalResultsReturned: "2",
      firstResultPosition: "2"
    },
    Result: {@attributes: {
        totalQandAAvailable: "2"
      },
      AuctionID: "a123456789",
      AuctionURL: "http://auctions.yahooapis.jp/AuctionWebService/V1/AuctionItem?auctionID=a123456789",
      StartTime: "1440514800",
      QandA: [{
        Title: "質問2",
        WhichQuestion: "2",
        Question: {
          Comment: "質問の者です。ご返答、ご検討よろしくお願い致します。",
          Date: " 2013-02-20T15:12:05+09:00	 ",
          Id: "tia*****",
          Rating: {
            Point: "1470",
            IsSuspended: "false",
            IsDeleted: "false"
          }
        },
        Answer: {
          Comment: "よろしくお願いします",
          Date: " 2013-02-22T01:33:59+09:00	 ",
          Id: "abcdef",
          Rating: {
            Point: "4573",
            IsSuspended: "false",
            IsDeleted: "false"
          },
          RatingURL: "http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef",
          ItemListURL: "http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=abcdef"
        }
      }, {
        Title: "質問3",
        WhichQuestion: "3",
        Question: {
          Comment: "ご検討いただけたらと思います。よろしくお願い致します。",
          Date: " 2013-02-25T17:16:07+09:00	 ",
          Id: "tia*****",
          Rating: {
            Point: "1470",
            IsSuspended: "false",
            IsDeleted: "false"
          }
        },
        Answer: {
          Comment: "何度も検討頂きありがとうございます。よろしくお願いします",
          Date: " 2013-02-25T18:46:43+09:00	 ",
          Id: "abcdef",
          Rating: {
            Point: "4573",
            IsSuspended: "false",
            IsDeleted: "false"
          },
          RatingURL: "http://auctions.yahooapis.jp/AuctionWebService/V1/ShowRating?id=abcdef",
          ItemListURL: "http://auctions.yahooapis.jp/AuctionWebService/V1/SellingList?sellerID=abcdef"
        }
      }]
    }
  }
})



エラー

Q&A取得はYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。